@zenofolio/hyper-decor 1.0.7 → 1.0.8

package/dist/lib/tree/tree.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAppTree = getAppTree;
+const meta_store_1 = require("../../__internals/stores/meta.store");
+const metadata_1 = require("../openapi/metadata");
+const path_util_1 = require("../../__internals/utils/path.util");
+const metadata_registry_1 = require("../openapi/metadata.registry");
+/**
+ * Extracts the complete application metadata tree.
+ */
+function getAppTree(Target) {
+    var _a;
+    const root = meta_store_1.Metadata.get(Target);
+    const common = (_a = root.server) === null || _a === void 0 ? void 0 : _a.common;
+    const prefix = (common === null || common === void 0 ? void 0 : common.prefix) || "/";
+    const tree = {
+        app: Object.assign(Object.assign({}, (common || {})), { target: Target, fullPath: prefix }),
+        modules: {},
+        paths: {}
+    };
+    const modules = (common === null || common === void 0 ? void 0 : common.modules) || [];
+    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 = {}) {
+    var _a;
+    const root = meta_store_1.Metadata.get(Target);
+    const common = (_a = root.server) === null || _a === void 0 ? void 0 : _a.common;
+    const currentPath = (0, path_util_1.join)(parentPath, (common === null || common === void 0 ? void 0 : common.path) || "");
+    const openapi = metadata_1.SwaggerMeta.get(Target); // Fixed: Metadata utility now returns root.common
+    // Execute custom collectors
+    metadata_registry_1.openApiRegistry.getCollectors("class").forEach(collector => {
+        const extra = collector(Target);
+        if (extra)
+            Object.assign(openapi, extra);
+    });
+    const node = {
+        metadata: common,
+        target: Target,
+        fullPath: currentPath,
+        modules: {},
+        controllers: {},
+        services: ((common === null || common === void 0 ? void 0 : common.imports) || []),
+        openapi: openapi
+    };
+    ((common === null || common === void 0 ? void 0 : common.modules) || []).forEach(m => {
+        node.modules[m.name] = getModuleNode(m, currentPath, globalPaths);
+    });
+    ((common === null || common === void 0 ? void 0 : common.controllers) || []).forEach(c => {
+        node.controllers[c.name] = getControllerNode(c, currentPath, globalPaths);
+    });
+    return node;
+}
+function getControllerNode(Target, parentPath = "", globalPaths = {}) {
+    var _a;
+    const root = meta_store_1.Metadata.get(Target);
+    const common = (_a = root.server) === null || _a === void 0 ? void 0 : _a.common;
+    const currentPath = (0, path_util_1.join)(parentPath, (common === null || common === void 0 ? void 0 : common.path) || "");
+    const openapi = metadata_1.SwaggerMeta.get(Target);
+    const server = root.server || { common: {}, methods: {} };
+    const methods = server.methods;
+    const routes = Object.keys(methods).map((propertyKey) => {
+        var _a;
+        const methodMeta = methods[propertyKey];
+        const route = methodMeta.route;
+        if (!route)
+            return null;
+        const params = ((_a = methodMeta.params) === null || _a === void 0 ? void 0 : _a.params) || [];
+        const fullPath = (0, path_util_1.join)(currentPath, route.path);
+        // Get OpenAPI metadata for the method
+        const methodOpenApi = (metadata_1.SwaggerMeta.get(Target, propertyKey) || {});
+        // Execute custom collectors
+        metadata_registry_1.openApiRegistry.getCollectors("method").forEach((collector) => {
+            const extra = collector(Target.prototype, propertyKey);
+            if (extra)
+                Object.assign(methodOpenApi, extra);
+        });
+        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;
+    }).filter(Boolean);
+    // Execute custom collectors
+    metadata_registry_1.openApiRegistry.getCollectors("class").forEach(collector => {
+        const extra = collector(Target);
+        if (extra)
+            Object.assign(openapi, extra);
+    });
+    return {
+        metadata: common,
+        target: Target,
+        fullPath: currentPath,
+        routes,
+        services: (common === null || common === void 0 ? void 0 : common.imports) || [],
+        openapi: openapi
+    };
+}

package/package.json

@@ -1,15 +1,22 @@
 {
   "name": "@zenofolio/hyper-decor",
-  "version": "1.0.7",
+  "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",
-    "test:server": "vitest tests/server.bench.ts",
     "build": "tsc",
     "publish": "npm run build && npm publish --access public"
   },
@@ -26,6 +33,7 @@
     "vitest": "^4.0.18"
   },
   "dependencies": {
+    "@zenofolio/hyper-decor": "file:",
     "core-decorators": "^0.20.0",
     "eventemitter3": "^5.0.4",
     "file-type": "^19.5.0",

package/scripts/clean.js

@@ -1,56 +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);
+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

@@ -1,85 +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);
-});
+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/vitest.config.mjs

@@ -5,7 +5,7 @@ export default defineConfig({
   test: {
     globals: true,
     environment: 'node',
-    include: ['tests/**/*.{test,spec,bench}.ts', 'tests/*.{test,spec,bench}.ts'],
+    include: ['tests/**/*.{test,spec}.ts'],
     poolOptions: {
       threads: {
         singleThread: true,

package/debug.txt

@@ -1 +0,0 @@
-State: class-before-dep-ok

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

@@ -1,11 +0,0 @@
-import "reflect-metadata";
-import { Request } from "hyper-express/types";
-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 | "req" | "res", decoratorName: string, resolver: ParameterResolver, schema?: any, isWholeSource?: boolean): ParameterDecorator;

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

@@ -1,55 +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 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"));
-const function_util_1 = require("../utils/function.util");
-/**
- * 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, schema, isWholeSource) {
-    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.extractArgsNames)(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,
-                    schema,
-                    isWholeSource,
-                });
-                // 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,9 +0,0 @@
-import "reflect-metadata";
-/**
- * Helper function to create route decorators for HTTP methods.
- *
- * @param {string} method - The HTTP method (e.g., GET, POST).
- * @returns {(path?: string) => MethodDecorator} - A method decorator for defining routes.
- *
- */
-export default function createRouteDecorator<T extends any = undefined>(method: string): (path?: string, options?: T) => MethodDecorator & ClassDecorator;

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

@@ -1,39 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = createRouteDecorator;
-require("reflect-metadata");
-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).
- * @returns {(path?: string) => MethodDecorator} - A method decorator for defining routes.
- *
- */
-function createRouteDecorator(method) {
-    return (path = "/", options) => (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) => {
-            // add openAPI data here
-            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,
-                options,
-            });
-            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 {};