@zenofolio/hyper-decor 1.0.4 → 1.0.8

package/package.json

@@ -1,61 +1,82 @@
-{
-  "name": "@zenofolio/hyper-decor",
-  "version": "1.0.4",
-  "description": "Project core with utilities and features",
-  "main": "dist/index.js",
-  "author": "zenozaga",
-  "license": "MIT",
-  "scripts": {
-    "test": "mocha",
-    "test:server": "ts-node -r tsconfig-paths/register tests/server.bench.ts",
-    "build": "tsc",
-    "publish": "npm run build && npm publish --access public"
-  },
-  "peerDependencies": {
-    "hyper-express": "^6.17.3"
-  },
-  "devDependencies": {
-    "@types/file-type": "^10.9.3",
-    "@types/mocha": "^10.0.8",
-    "chai": "^5.1.2",
-    "mocha": "^10.7.3",
-    "nodemon": "3.1.7",
-    "ts-node": "^10.9.2",
-    "typescript": "5.6.2"
-  },
-  "dependencies": {
-    "@zenofolio/hyper-decor": "file:",
-    "core-decorators": "^0.20.0",
-    "file-type": "^19.5.0",
-    "hyper-express-decorators": "file:",
-    "reflect-metadata": "^0.2.2",
-    "tsyringe": "^4.8.0"
-  },
-  "exports": {
-    ".": {
-      "default": "./dist/index.js",
-      "node": "./dist/index.js",
-      "import": "./src/index.ts"
-    },
-    "./decorators/*": {
-      "node": "./dist/decorators/*.js",
-      "default": "./src/decorators/*.ts"
-    },
-    "./helpers/*": {
-      "node": "./dist/common/helpers/*.js",
-      "default": "./src/common/helpers/*.ts"
-    },
-    "./exceptions/*": {
-      "node": "./dist/common/exceptions/*.js",
-      "default": "./src/common/exceptions/*.ts"
-    },
-    "./extension": {
-      "node": "./dist/extension.js",
-      "default": "./src/extension.ts"
-    },
-    "./injector": {
-      "node": "./dist/injector.js",
-      "default": "./src/injector.ts"
-    }
-  }
+{
+  "name": "@zenofolio/hyper-decor",
+  "version": "1.0.8",
+  "description": "Project core with utilities and features",
+  "main": "dist/index.js",
+  "author": "zenozaga",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zenofolio/hyper-decor.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zenofolio/hyper-decor/issues"
+  },
+  "homepage": "https://github.com/zenofolio/hyper-decor#readme",
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "build": "tsc",
+    "publish": "npm run build && npm publish --access public"
+  },
+  "peerDependencies": {
+    "hyper-express": "^6.17.3"
+  },
+  "devDependencies": {
+    "@types/file-type": "10.6.0",
+    "@vitest/ui": "^4.0.18",
+    "nodemon": "3.1.7",
+    "typescript": "5.6.2",
+    "undici": "^7.24.0",
+    "unplugin-swc": "^1.5.9",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "@zenofolio/hyper-decor": "file:",
+    "core-decorators": "^0.20.0",
+    "eventemitter3": "^5.0.4",
+    "file-type": "^19.5.0",
+    "reflect-metadata": "^0.2.2",
+    "ts-type": "^3.0.8",
+    "tsyringe": "^4.8.0"
+  },
+  "exports": {
+    ".": {
+      "default": "./dist/index.js",
+      "node": "./dist/index.js",
+      "import": "./src/index.ts"
+    },
+    "./decorators/*": {
+      "node": "./dist/decorators/*.js",
+      "default": "./src/decorators/*.ts"
+    },
+    "./helpers/*": {
+      "node": "./dist/common/helpers/*.js",
+      "default": "./src/common/helpers/*.ts"
+    },
+    "./collectors/*": {
+      "node": "./dist/common/collectors/*.js",
+      "default": "./src/common/collectors/*.ts"
+    },
+    "./exceptions/*": {
+      "node": "./dist/common/exceptions/*.js",
+      "default": "./src/common/exceptions/*.ts"
+    },
+    "./extension": {
+      "node": "./dist/extension.js",
+      "default": "./src/extension.ts"
+    },
+    "./openapi": {
+      "node": "./dist/lib/openapi/index.js",
+      "default": "./src/lib/openapi/index.ts"
+    },
+    "./openapi/*": {
+      "node": "./dist/lib/openapi/*.js",
+      "default": "./src/lib/openapi/*.ts"
+    }
+  },
+  "bin": {
+    "hyper-clean-uws": "./scripts/clean.js"
+  }
 }

package/scripts/clean.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+
+try {
+  // Resolve where uWebSockets.js is actually installed
+  const mainModuleFile = require.resolve('uWebSockets.js');
+  // Usually this points to the root directory where the files are
+  const uwsDir = path.dirname(mainModuleFile);
+  
+  // Construct the expected binary name for THIS machine
+  const expectedBinary = 'uws_' + process.platform + '_' + process.arch + '_' + process.versions.modules + '.node';
+  
+  console.log(`[HyperDecor] Analyzing uWebSockets.js native binaries...`);
+  console.log(`[HyperDecor] Target environment: ${process.platform} ${process.arch} (Node ABI ${process.versions.modules})`);
+  console.log(`[HyperDecor] Expected binary: ${expectedBinary}`);
+
+  const files = fs.readdirSync(uwsDir);
+  let deletedCount = 0;
+  let savedSpace = 0;
+
+  files.forEach((file) => {
+    // We only care about .node files
+    if (!file.endsWith('.node')) return;
+
+    // If it's NOT the exact binary we need, delete it
+    if (file !== expectedBinary) {
+      const filePath = path.join(uwsDir, file);
+      const stat = fs.statSync(filePath);
+      savedSpace += stat.size;
+      fs.unlinkSync(filePath);
+      deletedCount++;
+    }
+  });
+
+  if (deletedCount > 0) {
+    const mbSaved = (savedSpace / 1024 / 1024).toFixed(2);
+    console.log(`[HyperDecor] ✅ Cleaned up ${deletedCount} unused native binaries.`);
+    console.log(`[HyperDecor] 💾 Freed up ${mbSaved} MB of disk space in node_modules!`);
+  } else {
+    // Make sure the expected one actually exists
+    if (!fs.existsSync(path.join(uwsDir, expectedBinary))) {
+      console.warn(`[HyperDecor] ⚠️ The expected native binary (${expectedBinary}) was NOT found! uWebSockets.js might not work.`);
+    } else {
+      console.log(`[HyperDecor] ✨ No unnecessary binaries found. Everything is already optimized.`);
+    }
+  }
+
+} catch (err) {
+  if (err.code === 'MODULE_NOT_FOUND') {
+    console.error(`[HyperDecor] ❌ uWebSockets.js is not installed locally. Skipping cleanup.`);
+  } else {
+    console.error(`[HyperDecor] ❌ Error cleaning uWebSockets binaries:`, err.message);
+  }
+  process.exit(1);
+}

package/scripts/test-server.ts

@@ -0,0 +1,85 @@
+import "reflect-metadata";
+import {
+  HyperApp,
+  HyperModule,
+  HyperService,
+  HyperController,
+  Get,
+  Post,
+  Res,
+  Body,
+  Response,
+  OnInit,
+  createApplication,
+  Transform,
+} from "../src";
+import { injectable } from "tsyringe";
+
+// 1. Setup a Mock Transformer (Zod-like)
+const ZodTransformer = {
+  transform: ({ data, schema }: any) => {
+    if (schema._type === "zod") {
+      return { ...data, parsed: true, timestamp: Date.now() };
+    }
+    return data;
+  },
+};
+
+const mockSchema = { _type: "zod" };
+
+@injectable()
+@HyperService()
+class AnalyticsService implements OnInit {
+  async onInit() {
+    console.log("Service initialized");
+  }
+}
+
+@HyperController("/api")
+class MainController {
+  @Get("/status")
+  status(@Res() res: Response) {
+    res.json({ status: "alive" });
+  }
+
+  @Post("/user")
+  @Transform(mockSchema)
+  createUser(@Body() data: any) {
+    return data;
+  }
+}
+
+@HyperModule({
+  imports: [AnalyticsService],
+  controllers: [MainController]
+})
+class MainModule { }
+
+@HyperApp({
+  name: "Standalone Test App",
+  version: "1.0.0",
+  modules: [MainModule]
+})
+class FullApp { }
+
+async function run() {
+  console.log("Starting App...");
+  const app = await createApplication(FullApp);
+  app.useTransform(ZodTransformer);
+
+  const port = 3010;
+  await app.listen(port);
+  console.log(`Server listening on http://localhost:${port}`);
+
+  // Close after 5 seconds
+  setTimeout(async () => {
+    console.log("Closing server...");
+    await app.close();
+    process.exit(0);
+  }, 5000);
+}
+
+run().catch(err => {
+  console.error(err);
+  process.exit(1);
+});

package/tsconfig.json

@@ -1,17 +1,22 @@
 {
   "compilerOptions": {
-      "module": "Node16",
-      "moduleResolution": "Node16",
-      "strict": true,                                      /* Enable all strict type-checking options. */
-      "target": "es2016",                                  /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
-      "declaration": true,                              /* Generate .d.ts files from TypeScript and JavaScript files in your project. */                               /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
-      "outDir": "./dist",                                   /* Specify an output folder for all emitted files. */
-      "esModuleInterop": true,                             /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */
-      "forceConsistentCasingInFileNames": true,            /* Ensure that casing is correct in imports. */
-      "skipLibCheck": true,                                 /* Skip type checking all .d.ts files. */
-
-      "experimentalDecorators": true,
-      "emitDecoratorMetadata": true,
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "strict": true, /* Enable all strict type-checking options. */
+    "target": "es2016", /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
+    "declaration": true, /* Generate .d.ts files from TypeScript and JavaScript files in your project. */ /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
+    "outDir": "./dist", /* Specify an output folder for all emitted files. */
+    "esModuleInterop": true, /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */
+    "forceConsistentCasingInFileNames": true, /* Ensure that casing is correct in imports. */
+    "skipLibCheck": true, /* Skip type checking all .d.ts files. */
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
   },
-  "exclude": ["node_modules", "dist", "tests", "examples"],
+  "exclude": [
+    "node_modules",
+    "dist",
+    "tests",
+    "examples",
+    "scripts"
+  ],
 }

package/vitest.config.mjs

@@ -0,0 +1,30 @@
+import { defineConfig } from 'vitest/config';
+import swc from 'unplugin-swc';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['tests/**/*.{test,spec}.ts'],
+    poolOptions: {
+      threads: {
+        singleThread: true,
+      },
+    },
+  },
+  plugins: [
+    swc.vite({
+      jsc: {
+        parser: {
+          syntax: 'typescript',
+          decorators: true,
+          dynamicImport: true,
+        },
+        transform: {
+          legacyDecorator: true,
+          decoratorMetadata: true,
+        },
+      },
+    }),
+  ],
+});

package/.mocharc.js

@@ -1,5 +0,0 @@
-module.exports = {
-    "extension": ["ts"],
-    "spec": "**/*.spec.ts",
-    "require": "ts-node/register"
-};

package/dist/__internals/creators/request.creator.d.ts

@@ -1,12 +0,0 @@
-import "reflect-metadata";
-import { Request } from "hyper-express";
-import { ByPassKeys } from "../stores/params.store";
-import { ParameterResolver } from "../../decorators";
-/**
- * Creates a parameter decorator for handling request data.
- *
- * @param {keyof Request | ByPassKeys} key - The key to extract from the request.
- * @param {IParamsResolver} resolver - Resolver function to handle the parameter.
- * @returns {ParameterDecorator} - The parameter decorator function.
- */
-export default function createParamDecorator(key: keyof Request | ByPassKeys, decoratorName: string, resolver: ParameterResolver): ParameterDecorator;

package/dist/__internals/creators/request.creator.js

@@ -1,53 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = createParamDecorator;
-require("reflect-metadata");
-const function_util_1 = require("../utils/function.util");
-const constants_1 = require("../constants");
-const decorator_base_1 = require("../decorator-base");
-const who_helper_1 = __importDefault(require("../helpers/who.helper"));
-const WrongPlaceException_1 = __importDefault(require("../../exeptions/WrongPlaceException"));
-/**
- * Creates a parameter decorator for handling request data.
- *
- * @param {keyof Request | ByPassKeys} key - The key to extract from the request.
- * @param {IParamsResolver} resolver - Resolver function to handle the parameter.
- * @returns {ParameterDecorator} - The parameter decorator function.
- */
-function createParamDecorator(key, decoratorName, resolver) {
-    const _key = key;
-    return (0, decorator_base_1.DecoratorHelper)({
-        type: constants_1.KEY_TYPE_CONTROLLER,
-        key: constants_1.KEY_PARAMS_PARAM,
-        options: (options, Target, propertyKey, parameterIndex) => {
-            const { isProperty } = (0, who_helper_1.default)(Target, propertyKey, parameterIndex);
-            if (!isProperty)
-                throw new WrongPlaceException_1.default(decoratorName, "parameter", `${Target.constructor.name}.${propertyKey}`, Target);
-            const saved = options !== null && options !== void 0 ? options : { params: {} };
-            const names = (0, function_util_1.extreactArgsNames)(Target[propertyKey]);
-            const types = Reflect.getMetadata(constants_1.DESIGN_PARAMTYPES, Target, propertyKey);
-            const name = names === null || names === void 0 ? void 0 : names[parameterIndex];
-            const type = types === null || types === void 0 ? void 0 : types[parameterIndex];
-            if (name && saved) {
-                if (!saved.params[propertyKey]) {
-                    saved.params[propertyKey] = [];
-                }
-                saved.params[propertyKey].push({
-                    name,
-                    type,
-                    index: parameterIndex,
-                    key: _key,
-                    method: propertyKey.toString(),
-                    resolver,
-                });
-                // sort by index
-                saved.params[propertyKey].sort((a, b) => a.index - b.index);
-                Reflect.defineMetadata(constants_1.KEY_PARAMS_PARAM, saved, Target[propertyKey]);
-            }
-            return saved;
-        },
-    });
-}

package/dist/__internals/creators/routes.creator.d.ts

@@ -1,10 +0,0 @@
-import { Request, Response } from "hyper-express";
-/**
- * Helper function to create route decorators for HTTP methods.
- *
- * @param {string} method - The HTTP method (e.g., GET, POST).
- * @param {(req: Request, res: Response) => any} [resolver] - Optional resolver for the route.
- * @returns {(path?: string) => MethodDecorator} - A method decorator for defining routes.
- *
- */
-export default function createRouteDecorator(method: string, resolver?: (req: Request, res: Response) => any): (path?: string) => MethodDecorator & ClassDecorator;

package/dist/__internals/creators/routes.creator.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = createRouteDecorator;
-const constants_1 = require("../constants");
-const decorator_base_1 = require("../decorator-base");
-/**
- * Helper function to create route decorators for HTTP methods.
- *
- * @param {string} method - The HTTP method (e.g., GET, POST).
- * @param {(req: Request, res: Response) => any} [resolver] - Optional resolver for the route.
- * @returns {(path?: string) => MethodDecorator} - A method decorator for defining routes.
- *
- */
-function createRouteDecorator(method, resolver) {
-    return (path = "/") => (0, decorator_base_1.DecoratorHelper)({
-        type: constants_1.KEY_TYPE_CONTROLLER,
-        key: constants_1.KEY_PARAMS_ROUTE,
-        targetResolver: (target) => { var _a; return (_a = target.constructor) !== null && _a !== void 0 ? _a : target; },
-        options: (data, Target, propertyKey, descriptor) => {
-            var _a;
-            const handler = descriptor.value;
-            if (typeof handler !== "function")
-                return data;
-            const saved = (_a = Reflect.getMetadata(constants_1.KEY_PARAMS_ROUTE, Target)) !== null && _a !== void 0 ? _a : {
-                routes: new Set(),
-            };
-            saved.routes.add({
-                className: Target.name,
-                method,
-                path,
-                propertyKey,
-                handler: handler,
-            });
-            return saved;
-        },
-    });
-}

package/dist/__internals/decorator-base.d.ts

@@ -1,30 +0,0 @@
-import "reflect-metadata";
-export type DecoratorBaseTypes = "APP" | "MODULE" | "CONTROLLER" | "ROUTE" | "MIDDLEWARE";
-type DefineResolve<T> = (old: T, target?: any, property?: any, descriptor?: any) => T;
-interface onDefineResolve<T> {
-    (data: {
-        key: string;
-        options: T;
-        target: any;
-        property?: any;
-        descriptor?: any;
-    }, defineData: (options: T) => void): void;
-}
-interface BeseDecoratorOptions<T extends any = any> {
-    type?: DecoratorBaseTypes | string;
-    key: string;
-    options: T | DefineResolve<T>;
-    targetResolver?: (target: any, propertyKey?: any, descriptorOrIndex?: any) => any;
-    onDefineData?: onDefineResolve<T>;
-}
-interface BeseDecorator<T> {
-    (target: T): any;
-    (target: T, propertyKey?: any, descriptor?: any): any;
-}
-type TransformFunction<TOptions, T> = (options: TOptions, target: T, propertyKey?: any, descriptor?: any) => any;
-export declare function DecoratorHelper<T, Target extends any = any>({ key, type, options, targetResolver, onDefineData }: BeseDecoratorOptions<T>, ...transformers: TransformFunction<T, Target>[]): BeseDecorator<Target>;
-export declare const defineDecorData: <T>(key: string, options: T | DefineResolve<T>, target: any, property?: any, descriptor?: any) => void;
-export declare const getDecorData: <T>(key: string, target: any, property?: any) => T;
-export declare const hasDecorData: (key: string, target: any, property?: any) => boolean;
-export declare const extractDecorData: <T>(target: any) => T | undefined;
-export {};

package/dist/__internals/decorator-base.js

@@ -1,86 +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);
-            }
-        }
-        (0, tsyringe_1.injectable)()((0, object_util_1.$constructor)(target));
-        return value;
-    };
-}
-const defineDecorData = (key, options, target, property, descriptor) => {
-    let value = options;
-    if (typeof options === "function") {
-        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);
-    }
-};
-exports.defineDecorData = defineDecorData;
-const getDecorData = (key, target, property) => property
-    ? Reflect.getMetadata(key, target, property)
-    : Reflect.getMetadata(key, target);
-exports.getDecorData = getDecorData;
-const hasDecorData = (key, target, property) => property
-    ? Reflect.hasMetadata(key, target, property)
-    : Reflect.hasMetadata(key, target);
-exports.hasDecorData = hasDecorData;
-const extractDecorData = (target) => {
-    const keys = Reflect.getMetadataKeys(target);
-    return keys.reduce((acc, key) => {
-        acc[key] = Reflect.getMetadata(key, target);
-        return acc;
-    }, {});
-};
-exports.extractDecorData = extractDecorData;

package/dist/__internals/store.d.ts

@@ -1,10 +0,0 @@
-export default class HyperAppStore {
-    private roles;
-    private scopes;
-    private modules;
-    private controllers;
-    private routes;
-    private middlewares;
-    addRole(role: string): void;
-    addModuleRole(module: string, role: string): void;
-}

package/dist/__internals/store.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-class HyperAppStore {
-    constructor() {
-        this.roles = new Set();
-        this.scopes = new Set();
-        this.modules = new Map();
-        this.controllers = new Map();
-        this.routes = new Map();
-        this.middlewares = new Map();
-    }
-    addRole(role) {
-        this.roles.add(role);
-    }
-    addModuleRole(module, role) { }
-}
-exports.default = HyperAppStore;

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

@@ -1,7 +0,0 @@
-import "reflect-metadata";
-import { MiddlewareHandler } from "hyper-express";
-export declare const middlewareStore: Readonly<{
-    get(target: any): any;
-    has(target: any): boolean;
-    set(target: any, ...middlewares: MiddlewareHandler[]): void;
-}>;

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

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.middlewareStore = void 0;
-require("reflect-metadata");
-const constants_1 = require("../constants");
-const { MIDDLEWARES } = constants_1.METADATA_KEYS;
-exports.middlewareStore = Object.freeze({
-    get(target) {
-        return Reflect.getMetadata(MIDDLEWARES, target);
-    },
-    has(target) {
-        return !!this.get(target);
-    },
-    set(target, ...middlewares) {
-        const list = this.get(target) || [];
-        list.push(...middlewares);
-        Reflect.defineMetadata(MIDDLEWARES, list, target);
-    },
-});