@zenofolio/hyper-decor 1.0.71 → 1.0.73

package/dist/lib/server/exeptions/NotRoleException.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const HyperException_1 = __importDefault(require("./HyperException"));
+class NotRoleException extends HyperException_1.default {
+    constructor(message = `Has not Permission to access this resource`, roles = [], requiredRoles = []) {
+        super(message, "NotRoleException", {
+            roles,
+            requiredRoles,
+        }, 403);
+        this.roles = roles;
+        this.requiredRoles = requiredRoles;
+    }
+}
+exports.default = NotRoleException;

package/dist/lib/server/exeptions/NotScopeException.d.ts

@@ -0,0 +1,7 @@
+import HyperException from "./HyperException";
+export default class NotScopeException extends HyperException {
+    message: string;
+    requestScopes: string[];
+    requiredScopes: string[];
+    constructor(message: string, requestScopes?: string[], requiredScopes?: string[]);
+}

package/dist/lib/server/exeptions/NotScopeException.js

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const HyperException_1 = __importDefault(require("./HyperException"));
+class NotScopeException extends HyperException_1.default {
+    constructor(message, requestScopes = [], requiredScopes = []) {
+        super(message || `You don't have the required scopes to access this resource`, "NotScopeException", {
+            requestScopes,
+            requiredScopes,
+        }, 403);
+        this.message = message;
+        this.requestScopes = requestScopes;
+        this.requiredScopes = requiredScopes;
+    }
+}
+exports.default = NotScopeException;

package/dist/lib/server/exeptions/WrongPlaceException.d.ts

@@ -0,0 +1,8 @@
+import HyperException from "./HyperException";
+export default class WrongPlaceException extends HyperException {
+    decorator: string;
+    as: string;
+    namespace: string;
+    target: any;
+    constructor(decorator: string, as: string, namespace: string, target: any);
+}

package/dist/lib/server/exeptions/WrongPlaceException.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const HyperException_1 = __importDefault(require("./HyperException"));
+class WrongPlaceException extends HyperException_1.default {
+    constructor(decorator, as, namespace, target) {
+        super(`The decorator @${decorator} only can be used as a ${as} decorator. Error => ${namespace}`, "WrongPlaceException", {
+            decorator,
+            target,
+            namespace,
+            as,
+        });
+        this.decorator = decorator;
+        this.as = as;
+        this.namespace = namespace;
+        this.target = target;
+    }
+}
+exports.default = WrongPlaceException;

package/dist/lib/server/exeptions/index.d.ts

@@ -0,0 +1,8 @@
+import DuplicatedHandlerException from "./DuplicatedHandlerException";
+import DuplicateControllerPathException from "./DuplicateControllerPathException";
+import HyperException from "./HyperException";
+import MethodNotFountException from "./MethodNotFountException";
+import NotRoleException from "./NotRoleException";
+import NotScopeException from "./NotScopeException";
+export type * from "./types";
+export { DuplicatedHandlerException, DuplicateControllerPathException as DuplicatedRouterException, HyperException, NotRoleException, NotScopeException, MethodNotFountException as MethodNotExists, };

package/dist/lib/server/exeptions/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MethodNotExists = exports.NotScopeException = exports.NotRoleException = exports.HyperException = exports.DuplicatedRouterException = exports.DuplicatedHandlerException = void 0;
+const DuplicatedHandlerException_1 = __importDefault(require("./DuplicatedHandlerException"));
+exports.DuplicatedHandlerException = DuplicatedHandlerException_1.default;
+const DuplicateControllerPathException_1 = __importDefault(require("./DuplicateControllerPathException"));
+exports.DuplicatedRouterException = DuplicateControllerPathException_1.default;
+const HyperException_1 = __importDefault(require("./HyperException"));
+exports.HyperException = HyperException_1.default;
+const MethodNotFountException_1 = __importDefault(require("./MethodNotFountException"));
+exports.MethodNotExists = MethodNotFountException_1.default;
+const NotRoleException_1 = __importDefault(require("./NotRoleException"));
+exports.NotRoleException = NotRoleException_1.default;
+const NotScopeException_1 = __importDefault(require("./NotScopeException"));
+exports.NotScopeException = NotScopeException_1.default;

package/dist/lib/server/exeptions/types.d.ts

@@ -0,0 +1 @@
+export type ExceptionType = "DuplicateControllerException" | "DuplicateHandlerException" | "DuplicateRouterException" | "HyperException" | "NotRoleException" | "NotScopeException" | "MethodNotFountException" | "DuplicateControllerPathException" | "DuplicateHandlerException" | "DuplicatedException" | "NotPropertyException" | "WrongPlaceException" | "HyperFileException" | "DpublicateModuleException";

package/dist/lib/server/exeptions/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/tree/tree.d.ts

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

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,6 +1,6 @@
 {
   "name": "@zenofolio/hyper-decor",
-  "version": "1.0.71",
+  "version": "1.0.73",
   "description": "Project core with utilities and features",
   "main": "dist/index.js",
   "author": "zenozaga",

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);
+#!/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

@@ -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

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