@asenajs/asena 0.6.2 → 0.7.0

package/dist/lib/utils/metadataExtractor.js

@@ -0,0 +1,105 @@
+import { ComponentConstants } from '../ioc/constants';
+import { ComponentType } from '../ioc/types';
+import { getOwnTypedMetadata, getTypedMetadata } from './typedMetadata';
+/**
+ * Extracts route metadata from a controller instance.
+ *
+ * @param controller - A resolved controller instance from the container
+ * @returns Controller route information including base path, name, and route definitions
+ *
+ * @example
+ * ```typescript
+ * const controllers = await container.resolveAll(ComponentType.CONTROLLER);
+ * for (const controller of controllers) {
+ *   const info = extractControllerRouteInfo(controller);
+ *   console.log(info.basePath, info.controllerName, Object.keys(info.routes));
+ * }
+ * ```
+ */
+export function extractControllerRouteInfo(controller) {
+    const constructor = controller?.constructor;
+    return {
+        basePath: getOwnTypedMetadata(ComponentConstants.PathKey, constructor) || '',
+        controllerName: getTypedMetadata(ComponentConstants.NameKey, constructor) || '',
+        description: getOwnTypedMetadata(ComponentConstants.ControllerDescriptionKey, constructor) || '',
+        routes: getOwnTypedMetadata(ComponentConstants.RouteKey, constructor) || {},
+    };
+}
+/**
+ * Extracts the registered component name from a class or instance.
+ *
+ * @param target - A class constructor or instance
+ * @returns The component name, or empty string if not found
+ *
+ * @example
+ * ```typescript
+ * const name = extractComponentName(MyValidator);
+ * const validator = await container.resolve(name);
+ * ```
+ */
+export function extractComponentName(target) {
+    const constructor = typeof target === 'function' ? target : target?.constructor;
+    return getTypedMetadata(ComponentConstants.NameKey, constructor) || '';
+}
+// ─── Component Type Query Utilities ───
+// Stable public API for @asenajs/* package developers.
+// Wraps internal ComponentConstants symbols — safe across versions.
+/**
+ * Checks if a class is decorated with `@Middleware({ validator: true })`.
+ *
+ * @param target - A class constructor
+ * @returns true if the class is a validator middleware
+ *
+ * @example
+ * ```typescript
+ * // In a PostProcessor:
+ * postProcess<T>(instance: T, Class: any): T {
+ *   if (isValidator(Class)) {
+ *     // collect validator instance
+ *   }
+ *   return instance;
+ * }
+ * ```
+ */
+export function isValidator(target) {
+    return getOwnTypedMetadata(ComponentConstants.ValidatorKey, target) === true;
+}
+/**
+ * Checks if a class is decorated with `@Controller`.
+ *
+ * @param target - A class constructor
+ */
+export function isController(target) {
+    return getOwnTypedMetadata(ComponentType.CONTROLLER, target) === true;
+}
+/**
+ * Checks if a class is decorated with `@Service`.
+ *
+ * @param target - A class constructor
+ */
+export function isService(target) {
+    return getOwnTypedMetadata(ComponentType.SERVICE, target) === true;
+}
+/**
+ * Checks if a class is decorated with `@Middleware`.
+ *
+ * @param target - A class constructor
+ */
+export function isMiddleware(target) {
+    return getOwnTypedMetadata(ComponentType.MIDDLEWARE, target) === true;
+}
+/**
+ * Returns the component type string if the class is an Asena component.
+ *
+ * @param target - A class constructor
+ * @returns Component type ('SERVICE', 'CONTROLLER', 'MIDDLEWARE', etc.) or undefined
+ */
+export function getComponentType(target) {
+    for (const type of Object.values(ComponentType)) {
+        if (getOwnTypedMetadata(type, target) === true) {
+            return type;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=metadataExtractor.js.map

package/dist/lib/utils/metadataExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataExtractor.js","sourceRoot":"","sources":["../../../lib/utils/metadataExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAmBxE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,0BAA0B,CAAC,UAAe;IACxD,MAAM,WAAW,GAAG,UAAU,EAAE,WAAW,CAAC;IAE5C,OAAO;QACL,QAAQ,EAAE,mBAAmB,CAAS,kBAAkB,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE;QACpF,cAAc,EAAE,gBAAgB,CAAS,kBAAkB,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE;QACvF,WAAW,EAAE,mBAAmB,CAAS,kBAAkB,CAAC,wBAAwB,EAAE,WAAW,CAAC,IAAI,EAAE;QACxG,MAAM,EAAE,mBAAmB,CAAQ,kBAAkB,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,EAAE;KACnF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAW;IAC9C,MAAM,WAAW,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC;IAEhF,OAAO,gBAAgB,CAAS,kBAAkB,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;AACjF,CAAC;AAED,yCAAyC;AACzC,uDAAuD;AACvD,oEAAoE;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CAAC,MAAW;IACrC,OAAO,mBAAmB,CAAU,kBAAkB,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AACxF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAW;IACtC,OAAO,mBAAmB,CAAU,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AACjF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAW;IACnC,OAAO,mBAAmB,CAAU,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAW;IACtC,OAAO,mBAAmB,CAAU,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAW;IAC1C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAChD,IAAI,mBAAmB,CAAU,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/lib/utils/patternMatcher.js

@@ -20,8 +20,11 @@
  * matchesPattern('/health', '/api/*') // => false
  */
 export function matchesPattern(path, pattern) {
-    // Exact match
-    if (path === pattern) {
+    // Normalize trailing slashes for consistent matching (except root '/')
+    const normalizedPath = path.length > 1 && path.endsWith('/') ? path.slice(0, -1) : path;
+    const normalizedPattern = pattern.length > 1 && pattern.endsWith('/') ? pattern.slice(0, -1) : pattern;
+    // Exact match (with trailing slash normalization)
+    if (normalizedPath === normalizedPattern) {
         return true;
     }
     // Wildcard pattern: /api/* matches /api/users, /api/users/123, etc.

package/dist/lib/utils/patternMatcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"patternMatcher.js","sourceRoot":"","sources":["../../../lib/utils/patternMatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAe;IAC1D,cAAc;IACd,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oEAAoE;IACpE,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,YAAY,GAAG,OAAO;aACzB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACf,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC,CAAC,uBAAuB;YACtC,CAAC;YAED,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,mBAAmB;YAC1D,CAAC;YAED,OAAO,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,uBAAuB;QAChF,CAAC,CAAC;aACD,IAAI,CAAC,KAAK,CAAC,CAAC;QAEf,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;QAE9C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,qEAAqE;IACrE,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,YAAY,GAAG,OAAO;aACzB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACf,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5B,OAAO,OAAO,CAAC,CAAC,iCAAiC;YACnD,CAAC;YAED,OAAO,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,uBAAuB;QAChF,CAAC,CAAC;aACD,IAAI,CAAC,KAAK,CAAC,CAAC;QAEf,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;QAE9C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,WAAW;IACX,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAAoC;IACtF,sCAAsC;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAEjD,gDAAgD;IAChD,KAAK,MAAM,cAAc,IAAI,OAAO,EAAE,CAAC;QACrC,IAAI,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC;YACzC,OAAO,KAAK,CAAC,CAAC,wBAAwB;QACxC,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,KAAK,MAAM,cAAc,IAAI,OAAO,EAAE,CAAC;QACrC,IAAI,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC,CAAC,mCAAmC;QAClD,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"patternMatcher.js","sourceRoot":"","sources":["../../../lib/utils/patternMatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAe;IAC1D,uEAAuE;IACvE,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxF,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAEvG,kDAAkD;IAClD,IAAI,cAAc,KAAK,iBAAiB,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oEAAoE;IACpE,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,YAAY,GAAG,OAAO;aACzB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACf,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC,CAAC,uBAAuB;YACtC,CAAC;YAED,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,mBAAmB;YAC1D,CAAC;YAED,OAAO,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,uBAAuB;QAChF,CAAC,CAAC;aACD,IAAI,CAAC,KAAK,CAAC,CAAC;QAEf,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;QAE9C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,qEAAqE;IACrE,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,YAAY,GAAG,OAAO;aACzB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACf,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5B,OAAO,OAAO,CAAC,CAAC,iCAAiC;YACnD,CAAC;YAED,OAAO,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,uBAAuB;QAChF,CAAC,CAAC;aACD,IAAI,CAAC,KAAK,CAAC,CAAC;QAEf,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;QAE9C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,WAAW;IACX,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAAoC;IACtF,sCAAsC;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAEjD,gDAAgD;IAChD,KAAK,MAAM,cAAc,IAAI,OAAO,EAAE,CAAC;QACrC,IAAI,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC;YACzC,OAAO,KAAK,CAAC,CAAC,wBAAwB;QACxC,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,KAAK,MAAM,cAAc,IAAI,OAAO,EAAE,CAAC;QACrC,IAAI,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC,CAAC,mCAAmC;QAClD,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asenajs/asena",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "author": "LibirSoft",
   "repository": {
     "type": "git",
@@ -12,15 +12,15 @@
     "reflect-metadata": "^0.2.2"
   },
   "devDependencies": {
-    "@changesets/cli": "^2.29.7",
+    "@changesets/cli": "^2.30.0",
     "@types/bun": "latest",
-    "@typescript-eslint/eslint-plugin": "^8.46.4",
-    "@typescript-eslint/parser": "^8.46.4",
-    "eslint": "^9.39.1",
+    "@typescript-eslint/eslint-plugin": "^8.57.2",
+    "@typescript-eslint/parser": "^8.57.2",
+    "eslint": "^9.39.4",
     "eslint-config-prettier": "^9.1.2",
-    "prettier": "^3.6.2",
+    "prettier": "^3.8.1",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.46.4"
+    "typescript-eslint": "^8.57.2"
   },
   "exports": {
     ".": {
@@ -39,7 +39,7 @@
       "import": "./dist/lib/server/web/websocket/index.js",
       "types": "./dist/lib/server/web/websocket/index.d.ts"
     },
-    "./web": {
+    "./decorators/http": {
       "import": "./dist/lib/server/web/decorators/index.js",
       "types": "./dist/lib/server/web/decorators/index.d.ts"
     },
@@ -47,7 +47,7 @@
       "import": "./dist/lib/server/web/types/index.js",
       "types": "./dist/lib/server/web/types/index.d.ts"
     },
-    "./server": {
+    "./decorators": {
       "import": "./dist/lib/server/decorators/index.js",
       "types": "./dist/lib/server/decorators/index.d.ts"
     },
@@ -55,13 +55,17 @@
       "import": "./dist/lib/server/config/index.js",
       "types": "./dist/lib/server/config/index.d.ts"
     },
-    "./ioc": {
+    "./decorators/ioc": {
       "import": "./dist/lib/ioc/component/index.js",
       "types": "./dist/lib/ioc/component/index.d.ts"
     },
-    "./ioc/system": {
-      "import": "./dist/lib/server/web/websocket/index.js",
-      "types": "./dist/lib/server/web/websocket/index.d.ts"
+    "./ioc/types": {
+      "import": "./dist/lib/ioc/types/index.js",
+      "types": "./dist/lib/ioc/types/index.d.ts"
+    },
+    "./ioc/constants": {
+      "import": "./dist/lib/ioc/constants/index.js",
+      "types": "./dist/lib/ioc/constants/index.d.ts"
     },
     "./http-status": {
       "import": "./dist/lib/server/web/http/HttpStatus.js",
@@ -83,7 +87,11 @@
       "import": "./dist/lib/server/event/index.js",
       "types": "./dist/lib/server/event/index.d.ts"
     },
-    "./utlis": {
+    "./schedule": {
+      "import": "./dist/lib/server/schedule/index.js",
+      "types": "./dist/lib/server/schedule/index.d.ts"
+    },
+    "./utils": {
       "import": "./dist/lib/utils/index.js",
       "types": "./dist/lib/utils/index.d.ts"
     },
@@ -118,7 +126,7 @@
     "test:coverage": "bun test --coverage",
     "build": "bun run clean && tsc",
     "clean": "rm -rf dist",
-    "pre-release": "bun update && bun run build",
+    "pre-release": "bun run check && bun test && bun run build",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "format": "prettier --write .",