@webpieces/http-routing 0.2.92 → 0.2.94

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/http-routing",
-  "version": "0.2.92",
+  "version": "0.2.94",
   "description": "Decorator-based routing with auto-wiring for WebPieces",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -21,8 +21,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@webpieces/http-api": "0.2.92",
-    "@webpieces/http-filters": "0.2.92",
+    "@webpieces/http-api": "0.2.94",
+    "@webpieces/http-filters": "0.2.94",
     "inversify": "7.10.4",
     "minimatch": "10.0.1"
   }

package/src/ApiRoutingFactory.d.ts

@@ -0,0 +1,57 @@
+import { Routes, RouteBuilder } from './WebAppMeta';
+import { AuthMeta } from '@webpieces/http-api';
+import 'reflect-metadata';
+/**
+ * Type representing a class constructor (abstract or concrete).
+ */
+export type ClassType<T = unknown> = Function & {
+    prototype: T;
+};
+/**
+ * ApiRoutingFactory - Automatically wire API interfaces to controllers.
+ * Reads @ApiPath/@Endpoint decorators from an API prototype class and
+ * registers POST routes for each endpoint.
+ *
+ * Replaces the old RESTApiRoutes class.
+ *
+ * Usage:
+ * ```typescript
+ * // In your ServerMeta:
+ * getRoutes(): Routes[] {
+ *   return [
+ *     new ApiRoutingFactory(SaveApi, SaveController),
+ *   ];
+ * }
+ * ```
+ */
+export declare class ApiRoutingFactory<TApi = unknown, TController extends TApi = TApi> implements Routes {
+    private apiMetaClass;
+    private controllerClass;
+    /**
+     * @param apiMetaClass - The API prototype class with @ApiPath/@Endpoint decorators
+     * @param controllerClass - The controller class that implements the API
+     */
+    constructor(apiMetaClass: ClassType<TApi>, controllerClass: ClassType<TController>);
+    /**
+     * Configure routes by reading @ApiPath + @Endpoint metadata.
+     * Validates controller methods and auth decorators in single loop.
+     */
+    configure(routeBuilder: RouteBuilder): void;
+    /**
+     * Get the filepath of the controller source file.
+     * Uses a heuristic based on the controller class name.
+     */
+    private getControllerFilepath;
+    /**
+     * Get auth metadata for a specific method, falling back to class-level.
+     */
+    getAuthMetaForMethod(methodName: string): AuthMeta | undefined;
+    /**
+     * Get the API interface class.
+     */
+    getApiClass(): ClassType<TApi>;
+    /**
+     * Get the controller class.
+     */
+    getControllerClass(): ClassType<TController>;
+}

package/src/ApiRoutingFactory.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiRoutingFactory = void 0;
+const WebAppMeta_1 = require("./WebAppMeta");
+const http_api_1 = require("@webpieces/http-api");
+require("reflect-metadata");
+const decorators_1 = require("./decorators");
+/**
+ * ApiRoutingFactory - Automatically wire API interfaces to controllers.
+ * Reads @ApiPath/@Endpoint decorators from an API prototype class and
+ * registers POST routes for each endpoint.
+ *
+ * Replaces the old RESTApiRoutes class.
+ *
+ * Usage:
+ * ```typescript
+ * // In your ServerMeta:
+ * getRoutes(): Routes[] {
+ *   return [
+ *     new ApiRoutingFactory(SaveApi, SaveController),
+ *   ];
+ * }
+ * ```
+ */
+// webpieces-disable no-any-unknown -- generic class requires unconstrained default type params
+class ApiRoutingFactory {
+    /**
+     * @param apiMetaClass - The API prototype class with @ApiPath/@Endpoint decorators
+     * @param controllerClass - The controller class that implements the API
+     */
+    constructor(apiMetaClass, controllerClass) {
+        this.apiMetaClass = apiMetaClass;
+        this.controllerClass = controllerClass;
+        // Validate that apiMetaClass is marked with @ApiPath
+        if (!(0, http_api_1.isApiPath)(apiMetaClass)) {
+            const className = apiMetaClass.name || 'Unknown';
+            throw new Error(`Class ${className} must be decorated with @ApiPath()`);
+        }
+    }
+    /**
+     * Configure routes by reading @ApiPath + @Endpoint metadata.
+     * Validates controller methods and auth decorators in single loop.
+     */
+    configure(routeBuilder) {
+        const basePath = (0, http_api_1.getApiPath)(this.apiMetaClass);
+        const endpoints = (0, http_api_1.getEndpoints)(this.apiMetaClass) || {};
+        const controllerFilepath = this.getControllerFilepath();
+        const apiName = this.apiMetaClass.name || 'Unknown';
+        const controllerName = this.controllerClass.name || 'Unknown';
+        for (const [methodName, endpointPath] of Object.entries(endpoints)) {
+            // Validate controller implements this method
+            if (typeof this.controllerClass.prototype[methodName] !== 'function') {
+                throw new Error(`Controller ${controllerName} must implement method ${methodName} from API ${apiName}`);
+            }
+            // Validate auth decorator exists (class-level or method-level)
+            const authMeta = (0, http_api_1.getAuthMeta)(this.apiMetaClass, methodName);
+            if (!authMeta) {
+                throw new Error(`Endpoint '${methodName}' in ${apiName} has no @Authentication decorator. ` +
+                    `Add @Authentication(new AuthenticationConfig(...)) to the class or method.`);
+            }
+            const fullPath = basePath + endpointPath;
+            const routeMeta = new http_api_1.RouteMetadata('POST', fullPath, methodName, controllerName, authMeta);
+            routeBuilder.addRoute(new WebAppMeta_1.RouteDefinition(routeMeta, this.controllerClass, controllerFilepath));
+        }
+    }
+    /**
+     * Get the filepath of the controller source file.
+     * Uses a heuristic based on the controller class name.
+     */
+    getControllerFilepath() {
+        // Check for explicit @SourceFile decorator metadata
+        const filepath = Reflect.getMetadata(decorators_1.ROUTING_METADATA_KEYS.SOURCE_FILEPATH, this.controllerClass);
+        if (filepath) {
+            return filepath;
+        }
+        // Fallback to class name pattern
+        const className = this.controllerClass.name;
+        return className ? `**/${className}.ts` : undefined;
+    }
+    /**
+     * Get auth metadata for a specific method, falling back to class-level.
+     */
+    getAuthMetaForMethod(methodName) {
+        return (0, http_api_1.getAuthMeta)(this.apiMetaClass, methodName);
+    }
+    /**
+     * Get the API interface class.
+     */
+    getApiClass() {
+        return this.apiMetaClass;
+    }
+    /**
+     * Get the controller class.
+     */
+    getControllerClass() {
+        return this.controllerClass;
+    }
+}
+exports.ApiRoutingFactory = ApiRoutingFactory;
+//# sourceMappingURL=ApiRoutingFactory.js.map

package/src/ApiRoutingFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiRoutingFactory.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/ApiRoutingFactory.ts"],"names":[],"mappings":"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","sourcesContent":["import { Routes, RouteBuilder, RouteDefinition } from './WebAppMeta';\nimport { isApiPath, getApiPath, getEndpoints, getAuthMeta, RouteMetadata, AuthMeta } from '@webpieces/http-api';\nimport 'reflect-metadata';\nimport { ROUTING_METADATA_KEYS } from './decorators';\n\n/**\n * Type representing a class constructor (abstract or concrete).\n */\n// webpieces-disable no-any-unknown -- generic type alias requires unconstrained default\nexport type ClassType<T = unknown> = Function & { prototype: T };\n\n/**\n * ApiRoutingFactory - Automatically wire API interfaces to controllers.\n * Reads @ApiPath/@Endpoint decorators from an API prototype class and\n * registers POST routes for each endpoint.\n *\n * Replaces the old RESTApiRoutes class.\n *\n * Usage:\n * ```typescript\n * // In your ServerMeta:\n * getRoutes(): Routes[] {\n *   return [\n *     new ApiRoutingFactory(SaveApi, SaveController),\n *   ];\n * }\n * ```\n */\n// webpieces-disable no-any-unknown -- generic class requires unconstrained default type params\nexport class ApiRoutingFactory<TApi = unknown, TController extends TApi = TApi> implements Routes {\n    private apiMetaClass: ClassType<TApi>;\n    private controllerClass: ClassType<TController>;\n\n    /**\n     * @param apiMetaClass - The API prototype class with @ApiPath/@Endpoint decorators\n     * @param controllerClass - The controller class that implements the API\n     */\n    constructor(apiMetaClass: ClassType<TApi>, controllerClass: ClassType<TController>) {\n        this.apiMetaClass = apiMetaClass;\n        this.controllerClass = controllerClass;\n\n        // Validate that apiMetaClass is marked with @ApiPath\n        if (!isApiPath(apiMetaClass)) {\n            const className = apiMetaClass.name || 'Unknown';\n            throw new Error(`Class ${className} must be decorated with @ApiPath()`);\n        }\n\n    }\n\n    /**\n     * Configure routes by reading @ApiPath + @Endpoint metadata.\n     * Validates controller methods and auth decorators in single loop.\n     */\n    configure(routeBuilder: RouteBuilder): void {\n        const basePath = getApiPath(this.apiMetaClass)!;\n        const endpoints = getEndpoints(this.apiMetaClass) || {};\n        const controllerFilepath = this.getControllerFilepath();\n        const apiName = this.apiMetaClass.name || 'Unknown';\n        const controllerName = this.controllerClass.name || 'Unknown';\n\n        for (const [methodName, endpointPath] of Object.entries(endpoints)) {\n            // Validate controller implements this method\n            if (typeof this.controllerClass.prototype[methodName] !== 'function') {\n                throw new Error(\n                    `Controller ${controllerName} must implement method ${methodName} from API ${apiName}`,\n                );\n            }\n\n            // Validate auth decorator exists (class-level or method-level)\n            const authMeta = getAuthMeta(this.apiMetaClass, methodName);\n            if (!authMeta) {\n                throw new Error(\n                    `Endpoint '${methodName}' in ${apiName} has no @Authentication decorator. ` +\n                    `Add @Authentication(new AuthenticationConfig(...)) to the class or method.`,\n                );\n            }\n\n            const fullPath = basePath + endpointPath;\n            const routeMeta = new RouteMetadata(\n                'POST',\n                fullPath,\n                methodName,\n                controllerName,\n                authMeta,\n            );\n\n            routeBuilder.addRoute(new RouteDefinition(routeMeta, this.controllerClass, controllerFilepath));\n        }\n    }\n\n    /**\n     * Get the filepath of the controller source file.\n     * Uses a heuristic based on the controller class name.\n     */\n    private getControllerFilepath(): string | undefined {\n        // Check for explicit @SourceFile decorator metadata\n        const filepath = Reflect.getMetadata(\n            ROUTING_METADATA_KEYS.SOURCE_FILEPATH,\n            this.controllerClass,\n        );\n        if (filepath) {\n            return filepath;\n        }\n\n        // Fallback to class name pattern\n        const className = this.controllerClass.name;\n        return className ? `**/${className}.ts` : undefined;\n    }\n\n    /**\n     * Get auth metadata for a specific method, falling back to class-level.\n     */\n    getAuthMetaForMethod(methodName: string): AuthMeta | undefined {\n        return getAuthMeta(this.apiMetaClass, methodName);\n    }\n\n    /**\n     * Get the API interface class.\n     */\n    getApiClass(): ClassType<TApi> {\n        return this.apiMetaClass;\n    }\n\n    /**\n     * Get the controller class.\n     */\n    getControllerClass(): ClassType<TController> {\n        return this.controllerClass;\n    }\n}\n"]}

package/src/MethodMeta.d.ts

@@ -1,4 +1,4 @@
-import { RouteMetadata } from '@webpieces/http-api';
+import { RouteMetadata, AuthMeta } from '@webpieces/http-api';
 /**
  * Metadata about the method being invoked.
  * Passed to filters and contains request information.
@@ -42,12 +42,17 @@ export declare class MethodMeta {
      * The deserialized request DTO.
      */
     requestDto?: unknown;
+    /**
+     * Auth metadata from @Public/@Authenticated/@Roles decorators.
+     * Populated by ApiRoutingFactory so filters can read auth requirements.
+     */
+    authMeta?: AuthMeta;
     /**
      * Additional metadata for storing request-scoped data.
      * Used by filters to pass data to other filters/controllers.
      */
     metadata: Map<string, unknown>;
-    constructor(routeMeta: RouteMetadata, requestHeaders?: Map<string, string[]>, requestDto?: unknown, metadata?: Map<string, unknown>);
+    constructor(routeMeta: RouteMetadata, requestHeaders?: Map<string, string[]>, requestDto?: unknown, metadata?: Map<string, unknown>, authMeta?: AuthMeta);
     /**
      * Get the HTTP method (convenience accessor).
      */

package/src/MethodMeta.js

@@ -14,11 +14,12 @@ exports.MethodMeta = void 0;
  * - metadata: Request-scoped data for filters to communicate
  */
 class MethodMeta {
-    constructor(routeMeta, requestHeaders, requestDto, metadata) {
+    constructor(routeMeta, requestHeaders, requestDto, metadata, authMeta) {
         this.routeMeta = routeMeta;
         this.requestHeaders = requestHeaders;
         this.requestDto = requestDto;
         this.metadata = metadata ?? new Map();
+        this.authMeta = authMeta ?? routeMeta.authMeta;
     }
     /**
      * Get the HTTP method (convenience accessor).

package/src/MethodMeta.js.map

@@ -1 +1 @@
-{"version":3,"file":"MethodMeta.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/MethodMeta.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;GAWG;AACH,MAAa,UAAU;IAwCnB,YACI,SAAwB,EACxB,cAAsC,EACtC,UAAoB,EACpB,QAA+B;QAE/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,IAAI,GAAG,EAAE,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;IACrC,CAAC;CACJ;AAxED,gCAwEC","sourcesContent":["import { RouteMetadata } from '@webpieces/http-api';\n\n/**\n * Metadata about the method being invoked.\n * Passed to filters and contains request information.\n *\n * MethodMeta is DTO-only - it does NOT contain Express req/res directly.\n *\n * Fields:\n * - routeMeta: Static route information (httpMethod, path, methodName)\n * - requestHeaders: HTTP headers from the request (NEW)\n * - requestDto: The deserialized request body\n * - metadata: Request-scoped data for filters to communicate\n */\nexport class MethodMeta {\n    /**\n     * Route metadata (httpMethod, path, methodName, parameterTypes)\n     */\n    routeMeta: RouteMetadata;\n\n    /**\n     * HTTP headers from the request.\n     * Map of header name (lowercase) -> array of values.\n     *\n     * HTTP spec allows multiple values for same header name,\n     * so we store as string[] (even though most headers have single value).\n     *\n     * LIFECYCLE:\n     * 1. Set by ExpressWrapper BEFORE filter chain executes\n     * 2. ContextFilter (priority 2000) transfers headers to RequestContext\n     * 3. ContextFilter CLEARS this field (sets to undefined) after transfer\n     * 4. ALL FILTERS AFTER ContextFilter will see this as UNDEFINED\n     *\n     * IMPORTANT: Downstream filters should NOT read from requestHeaders!\n     * Instead, use RequestContext.getHeader() to read headers after ContextFilter.\n     *\n     * Example (correct usage in downstream filters):\n     * ```typescript\n     * const requestId = RequestContext.getHeader(WebpiecesCoreHeaders.REQUEST_ID);\n     * ```\n     */\n    public requestHeaders?: Map<string, string[]>;\n\n    /**\n     * The deserialized request DTO.\n     */\n    requestDto?: unknown;\n\n    /**\n     * Additional metadata for storing request-scoped data.\n     * Used by filters to pass data to other filters/controllers.\n     */\n    metadata: Map<string, unknown>;\n\n    constructor(\n        routeMeta: RouteMetadata,\n        requestHeaders?: Map<string, string[]>,\n        requestDto?: unknown,\n        metadata?: Map<string, unknown>,\n    ) {\n        this.routeMeta = routeMeta;\n        this.requestHeaders = requestHeaders;\n        this.requestDto = requestDto;\n        this.metadata = metadata ?? new Map();\n    }\n\n    /**\n     * Get the HTTP method (convenience accessor).\n     */\n    get httpMethod(): string {\n        return this.routeMeta.httpMethod;\n    }\n\n    /**\n     * Get the request path (convenience accessor).\n     */\n    get path(): string {\n        return this.routeMeta.path;\n    }\n\n    /**\n     * Get the method name (convenience accessor).\n     */\n    get methodName(): string {\n        return this.routeMeta.methodName;\n    }\n}\n"]}
+{"version":3,"file":"MethodMeta.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/MethodMeta.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;GAWG;AACH,MAAa,UAAU;IA8CnB,YACI,SAAwB,EACxB,cAAsC,EACtC,UAAoB,EACpB,QAA+B,EAC/B,QAAmB;QAEnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,IAAI,GAAG,EAAE,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;IACrC,CAAC;CACJ;AAhFD,gCAgFC","sourcesContent":["import { RouteMetadata, AuthMeta } from '@webpieces/http-api';\n\n/**\n * Metadata about the method being invoked.\n * Passed to filters and contains request information.\n *\n * MethodMeta is DTO-only - it does NOT contain Express req/res directly.\n *\n * Fields:\n * - routeMeta: Static route information (httpMethod, path, methodName)\n * - requestHeaders: HTTP headers from the request (NEW)\n * - requestDto: The deserialized request body\n * - metadata: Request-scoped data for filters to communicate\n */\nexport class MethodMeta {\n    /**\n     * Route metadata (httpMethod, path, methodName, parameterTypes)\n     */\n    routeMeta: RouteMetadata;\n\n    /**\n     * HTTP headers from the request.\n     * Map of header name (lowercase) -> array of values.\n     *\n     * HTTP spec allows multiple values for same header name,\n     * so we store as string[] (even though most headers have single value).\n     *\n     * LIFECYCLE:\n     * 1. Set by ExpressWrapper BEFORE filter chain executes\n     * 2. ContextFilter (priority 2000) transfers headers to RequestContext\n     * 3. ContextFilter CLEARS this field (sets to undefined) after transfer\n     * 4. ALL FILTERS AFTER ContextFilter will see this as UNDEFINED\n     *\n     * IMPORTANT: Downstream filters should NOT read from requestHeaders!\n     * Instead, use RequestContext.getHeader() to read headers after ContextFilter.\n     *\n     * Example (correct usage in downstream filters):\n     * ```typescript\n     * const requestId = RequestContext.getHeader(WebpiecesCoreHeaders.REQUEST_ID);\n     * ```\n     */\n    public requestHeaders?: Map<string, string[]>;\n\n    /**\n     * The deserialized request DTO.\n     */\n    requestDto?: unknown;\n\n    /**\n     * Auth metadata from @Public/@Authenticated/@Roles decorators.\n     * Populated by ApiRoutingFactory so filters can read auth requirements.\n     */\n    authMeta?: AuthMeta;\n\n    /**\n     * Additional metadata for storing request-scoped data.\n     * Used by filters to pass data to other filters/controllers.\n     */\n    metadata: Map<string, unknown>;\n\n    constructor(\n        routeMeta: RouteMetadata,\n        requestHeaders?: Map<string, string[]>,\n        requestDto?: unknown,\n        metadata?: Map<string, unknown>,\n        authMeta?: AuthMeta,\n    ) {\n        this.routeMeta = routeMeta;\n        this.requestHeaders = requestHeaders;\n        this.requestDto = requestDto;\n        this.metadata = metadata ?? new Map();\n        this.authMeta = authMeta ?? routeMeta.authMeta;\n    }\n\n    /**\n     * Get the HTTP method (convenience accessor).\n     */\n    get httpMethod(): string {\n        return this.routeMeta.httpMethod;\n    }\n\n    /**\n     * Get the request path (convenience accessor).\n     */\n    get path(): string {\n        return this.routeMeta.path;\n    }\n\n    /**\n     * Get the method name (convenience accessor).\n     */\n    get methodName(): string {\n        return this.routeMeta.methodName;\n    }\n}\n"]}

package/src/index.d.ts

@@ -1,6 +1,6 @@
-export { ApiInterface, Get, Post, Put, Delete, Patch, Path, getRoutes, isApiInterface, RouteMetadata, METADATA_KEYS, ValidateImplementation, } from '@webpieces/http-api';
+export { ApiPath, Endpoint, Authentication, AuthenticationConfig, getApiPath, getEndpoints, isApiPath, getAuthMeta, AuthMeta, RouteMetadata, METADATA_KEYS, ValidateImplementation, } from '@webpieces/http-api';
 export { Controller, isController, provideSingleton, provideTransient, ROUTING_METADATA_KEYS, } from './decorators';
-export { RESTApiRoutes, ClassType } from './RESTApiRoutes';
+export { ApiRoutingFactory, ClassType } from './ApiRoutingFactory';
 export { WebAppMeta, WEBAPP_META_TOKEN, Routes, RouteBuilder, RouteDefinition, FilterDefinition, } from './WebAppMeta';
 export { MethodMeta } from './MethodMeta';
 export { RouteHandler } from './RouteHandler';

package/src/index.js

@@ -1,17 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WEBPIECES_CONFIG_TOKEN = exports.WebpiecesConfig = exports.RequestContextReader = exports.FilterMatcher = exports.FilterWithMeta = exports.RouteHandlerWithMeta = exports.RouteBuilderImpl = exports.RouteHandler = exports.MethodMeta = exports.FilterDefinition = exports.RouteDefinition = exports.WEBAPP_META_TOKEN = exports.RESTApiRoutes = exports.ROUTING_METADATA_KEYS = exports.provideTransient = exports.provideSingleton = exports.isController = exports.Controller = exports.METADATA_KEYS = exports.RouteMetadata = exports.isApiInterface = exports.getRoutes = exports.Path = exports.Patch = exports.Delete = exports.Put = exports.Post = exports.Get = exports.ApiInterface = void 0;
+exports.WEBPIECES_CONFIG_TOKEN = exports.WebpiecesConfig = exports.RequestContextReader = exports.FilterMatcher = exports.FilterWithMeta = exports.RouteHandlerWithMeta = exports.RouteBuilderImpl = exports.RouteHandler = exports.MethodMeta = exports.FilterDefinition = exports.RouteDefinition = exports.WEBAPP_META_TOKEN = exports.ApiRoutingFactory = exports.ROUTING_METADATA_KEYS = exports.provideTransient = exports.provideSingleton = exports.isController = exports.Controller = exports.METADATA_KEYS = exports.RouteMetadata = exports.AuthMeta = exports.getAuthMeta = exports.isApiPath = exports.getEndpoints = exports.getApiPath = exports.AuthenticationConfig = exports.Authentication = exports.Endpoint = exports.ApiPath = void 0;
 // Re-export API decorators from http-api for convenience
 var http_api_1 = require("@webpieces/http-api");
-Object.defineProperty(exports, "ApiInterface", { enumerable: true, get: function () { return http_api_1.ApiInterface; } });
-Object.defineProperty(exports, "Get", { enumerable: true, get: function () { return http_api_1.Get; } });
-Object.defineProperty(exports, "Post", { enumerable: true, get: function () { return http_api_1.Post; } });
-Object.defineProperty(exports, "Put", { enumerable: true, get: function () { return http_api_1.Put; } });
-Object.defineProperty(exports, "Delete", { enumerable: true, get: function () { return http_api_1.Delete; } });
-Object.defineProperty(exports, "Patch", { enumerable: true, get: function () { return http_api_1.Patch; } });
-Object.defineProperty(exports, "Path", { enumerable: true, get: function () { return http_api_1.Path; } });
-Object.defineProperty(exports, "getRoutes", { enumerable: true, get: function () { return http_api_1.getRoutes; } });
-Object.defineProperty(exports, "isApiInterface", { enumerable: true, get: function () { return http_api_1.isApiInterface; } });
+Object.defineProperty(exports, "ApiPath", { enumerable: true, get: function () { return http_api_1.ApiPath; } });
+Object.defineProperty(exports, "Endpoint", { enumerable: true, get: function () { return http_api_1.Endpoint; } });
+Object.defineProperty(exports, "Authentication", { enumerable: true, get: function () { return http_api_1.Authentication; } });
+Object.defineProperty(exports, "AuthenticationConfig", { enumerable: true, get: function () { return http_api_1.AuthenticationConfig; } });
+Object.defineProperty(exports, "getApiPath", { enumerable: true, get: function () { return http_api_1.getApiPath; } });
+Object.defineProperty(exports, "getEndpoints", { enumerable: true, get: function () { return http_api_1.getEndpoints; } });
+Object.defineProperty(exports, "isApiPath", { enumerable: true, get: function () { return http_api_1.isApiPath; } });
+Object.defineProperty(exports, "getAuthMeta", { enumerable: true, get: function () { return http_api_1.getAuthMeta; } });
+Object.defineProperty(exports, "AuthMeta", { enumerable: true, get: function () { return http_api_1.AuthMeta; } });
 Object.defineProperty(exports, "RouteMetadata", { enumerable: true, get: function () { return http_api_1.RouteMetadata; } });
 Object.defineProperty(exports, "METADATA_KEYS", { enumerable: true, get: function () { return http_api_1.METADATA_KEYS; } });
 // Server-side routing decorators and utilities
@@ -21,8 +21,8 @@ Object.defineProperty(exports, "isController", { enumerable: true, get: function
 Object.defineProperty(exports, "provideSingleton", { enumerable: true, get: function () { return decorators_1.provideSingleton; } });
 Object.defineProperty(exports, "provideTransient", { enumerable: true, get: function () { return decorators_1.provideTransient; } });
 Object.defineProperty(exports, "ROUTING_METADATA_KEYS", { enumerable: true, get: function () { return decorators_1.ROUTING_METADATA_KEYS; } });
-var RESTApiRoutes_1 = require("./RESTApiRoutes");
-Object.defineProperty(exports, "RESTApiRoutes", { enumerable: true, get: function () { return RESTApiRoutes_1.RESTApiRoutes; } });
+var ApiRoutingFactory_1 = require("./ApiRoutingFactory");
+Object.defineProperty(exports, "ApiRoutingFactory", { enumerable: true, get: function () { return ApiRoutingFactory_1.ApiRoutingFactory; } });
 // Core routing types (moved from core-meta)
 var WebAppMeta_1 = require("./WebAppMeta");
 Object.defineProperty(exports, "WEBAPP_META_TOKEN", { enumerable: true, get: function () { return WebAppMeta_1.WEBAPP_META_TOKEN; } });

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/index.ts"],"names":[],"mappings":";;;AAAA,yDAAyD;AACzD,gDAa6B;AAZzB,wGAAA,YAAY,OAAA;AACZ,+FAAA,GAAG,OAAA;AACH,gGAAA,IAAI,OAAA;AACJ,+FAAA,GAAG,OAAA;AACH,kGAAA,MAAM,OAAA;AACN,iGAAA,KAAK,OAAA;AACL,gGAAA,IAAI,OAAA;AACJ,qGAAA,SAAS,OAAA;AACT,0GAAA,cAAc,OAAA;AACd,yGAAA,aAAa,OAAA;AACb,yGAAA,aAAa,OAAA;AAIjB,+CAA+C;AAC/C,2CAMsB;AALlB,wGAAA,UAAU,OAAA;AACV,0GAAA,YAAY,OAAA;AACZ,8GAAA,gBAAgB,OAAA;AAChB,8GAAA,gBAAgB,OAAA;AAChB,mHAAA,qBAAqB,OAAA;AAGzB,iDAA2D;AAAlD,8GAAA,aAAa,OAAA;AAEtB,4CAA4C;AAC5C,2CAOsB;AALlB,+GAAA,iBAAiB,OAAA;AAGjB,6GAAA,eAAe,OAAA;AACf,8GAAA,gBAAgB,OAAA;AAGpB,oCAAoC;AACpC,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,+BAA+B;AAC/B,uDAK4B;AAJxB,oHAAA,gBAAgB,OAAA;AAChB,wHAAA,oBAAoB,OAAA;AACpB,kHAAA,cAAc,OAAA;AAIlB,kBAAkB;AAClB,iDAA4D;AAAnD,8GAAA,aAAa,OAAA;AAEtB,iCAAiC;AACjC,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAE7B,uBAAuB;AACvB,qDAA4E;AAAnE,kHAAA,eAAe,OAAA;AAAE,yHAAA,sBAAsB,OAAA","sourcesContent":["// Re-export API decorators from http-api for convenience\nexport {\n    ApiInterface,\n    Get,\n    Post,\n    Put,\n    Delete,\n    Patch,\n    Path,\n    getRoutes,\n    isApiInterface,\n    RouteMetadata,\n    METADATA_KEYS,\n    ValidateImplementation,\n} from '@webpieces/http-api';\n\n// Server-side routing decorators and utilities\nexport {\n    Controller,\n    isController,\n    provideSingleton,\n    provideTransient,\n    ROUTING_METADATA_KEYS,\n} from './decorators';\n\nexport { RESTApiRoutes, ClassType } from './RESTApiRoutes';\n\n// Core routing types (moved from core-meta)\nexport {\n    WebAppMeta,\n    WEBAPP_META_TOKEN,\n    Routes,\n    RouteBuilder,\n    RouteDefinition,\n    FilterDefinition,\n} from './WebAppMeta';\n\n// Method metadata and route handler\nexport { MethodMeta } from './MethodMeta';\nexport { RouteHandler } from './RouteHandler';\n\n// Route builder implementation\nexport {\n    RouteBuilderImpl,\n    RouteHandlerWithMeta,\n    FilterWithMeta,\n    ExpressRouteHandler,\n} from './RouteBuilderImpl';\n\n// Filter matching\nexport { FilterMatcher, HttpFilter } from './FilterMatcher';\n\n// Context readers (Node.js only)\nexport { RequestContextReader } from './RequestContextReader';\n\n// Server configuration\nexport { WebpiecesConfig, WEBPIECES_CONFIG_TOKEN } from './WebpiecesConfig';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/index.ts"],"names":[],"mappings":";;;AAAA,yDAAyD;AACzD,gDAa6B;AAZzB,mGAAA,OAAO,OAAA;AACP,oGAAA,QAAQ,OAAA;AACR,0GAAA,cAAc,OAAA;AACd,gHAAA,oBAAoB,OAAA;AACpB,sGAAA,UAAU,OAAA;AACV,wGAAA,YAAY,OAAA;AACZ,qGAAA,SAAS,OAAA;AACT,uGAAA,WAAW,OAAA;AACX,oGAAA,QAAQ,OAAA;AACR,yGAAA,aAAa,OAAA;AACb,yGAAA,aAAa,OAAA;AAIjB,+CAA+C;AAC/C,2CAMsB;AALlB,wGAAA,UAAU,OAAA;AACV,0GAAA,YAAY,OAAA;AACZ,8GAAA,gBAAgB,OAAA;AAChB,8GAAA,gBAAgB,OAAA;AAChB,mHAAA,qBAAqB,OAAA;AAGzB,yDAAmE;AAA1D,sHAAA,iBAAiB,OAAA;AAE1B,4CAA4C;AAC5C,2CAOsB;AALlB,+GAAA,iBAAiB,OAAA;AAGjB,6GAAA,eAAe,OAAA;AACf,8GAAA,gBAAgB,OAAA;AAGpB,oCAAoC;AACpC,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,+BAA+B;AAC/B,uDAK4B;AAJxB,oHAAA,gBAAgB,OAAA;AAChB,wHAAA,oBAAoB,OAAA;AACpB,kHAAA,cAAc,OAAA;AAIlB,kBAAkB;AAClB,iDAA4D;AAAnD,8GAAA,aAAa,OAAA;AAEtB,iCAAiC;AACjC,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAE7B,uBAAuB;AACvB,qDAA4E;AAAnE,kHAAA,eAAe,OAAA;AAAE,yHAAA,sBAAsB,OAAA","sourcesContent":["// Re-export API decorators from http-api for convenience\nexport {\n    ApiPath,\n    Endpoint,\n    Authentication,\n    AuthenticationConfig,\n    getApiPath,\n    getEndpoints,\n    isApiPath,\n    getAuthMeta,\n    AuthMeta,\n    RouteMetadata,\n    METADATA_KEYS,\n    ValidateImplementation,\n} from '@webpieces/http-api';\n\n// Server-side routing decorators and utilities\nexport {\n    Controller,\n    isController,\n    provideSingleton,\n    provideTransient,\n    ROUTING_METADATA_KEYS,\n} from './decorators';\n\nexport { ApiRoutingFactory, ClassType } from './ApiRoutingFactory';\n\n// Core routing types (moved from core-meta)\nexport {\n    WebAppMeta,\n    WEBAPP_META_TOKEN,\n    Routes,\n    RouteBuilder,\n    RouteDefinition,\n    FilterDefinition,\n} from './WebAppMeta';\n\n// Method metadata and route handler\nexport { MethodMeta } from './MethodMeta';\nexport { RouteHandler } from './RouteHandler';\n\n// Route builder implementation\nexport {\n    RouteBuilderImpl,\n    RouteHandlerWithMeta,\n    FilterWithMeta,\n    ExpressRouteHandler,\n} from './RouteBuilderImpl';\n\n// Filter matching\nexport { FilterMatcher, HttpFilter } from './FilterMatcher';\n\n// Context readers (Node.js only)\nexport { RequestContextReader } from './RequestContextReader';\n\n// Server configuration\nexport { WebpiecesConfig, WEBPIECES_CONFIG_TOKEN } from './WebpiecesConfig';\n"]}

package/src/RESTApiRoutes.d.ts

@@ -1,77 +0,0 @@
-import { Routes, RouteBuilder } from './WebAppMeta';
-/**
- * Type representing a class constructor (abstract or concrete).
- */
-export type ClassType<T = any> = Function & {
-    prototype: T;
-};
-/**
- * RESTApiRoutes - Automatically wire API interfaces to controllers.
- * Similar to Java WebPieces RESTApiRoutes.
- *
- * This class uses reflection (reflect-metadata) to read decorators from
- * an API interface class and automatically register routes that dispatch
- * to the corresponding controller methods.
- *
- * Usage:
- * ```typescript
- * // In your ServerMeta:
- * getRoutes(): Routes[] {
- *   return [
- *     new RESTApiRoutes(SaveApiPrototype, SaveController),
- *     // ... more routes
- *   ];
- * }
- * ```
- *
- * The API interface and controller must follow this pattern:
- * - API interface class has @ApiInterface() decorator
- * - Methods have @Post()/@Get()/etc and @Path() decorators
- * - Controller class implements the same interface
- * - Controller class has @Controller() decorator
- *
- * Type Parameters:
- * - TApi: The API prototype class type (abstract class with decorators)
- * - TController: The controller class type (must extend TApi)
- */
-export declare class RESTApiRoutes<TApi = any, TController extends TApi = any> implements Routes {
-    private apiMetaClass;
-    private controllerClass;
-    /**
-     * Create a new RESTApiRoutes.
-     *
-     * @param apiMetaClass - The API interface class with decorators (e.g., SaveApiPrototype)
-     * @param controllerClass - The controller class that implements the API (e.g., SaveController)
-     */
-    constructor(apiMetaClass: ClassType<TApi>, controllerClass: ClassType<TController>);
-    /**
-     * Validate that the controller implements all methods from the API interface.
-     */
-    private validateControllerImplementsApi;
-    /**
-     * Configure routes by reading metadata from the API interface.
-     */
-    configure(routeBuilder: RouteBuilder): void;
-    /**
-     * Register a single route with the route builder.
-     */
-    private registerRoute;
-    /**
-     * Get the filepath of the controller source file.
-     * Uses a heuristic based on the controller class name.
-     *
-     * Since TypeScript doesn't provide source file paths at runtime,
-     * we use the class name to create a pattern that filters can match against.
-     *
-     * @returns Filepath pattern or undefined
-     */
-    private getControllerFilepath;
-    /**
-     * Get the API interface class.
-     */
-    getApiClass(): any;
-    /**
-     * Get the controller class.
-     */
-    getControllerClass(): any;
-}

package/src/RESTApiRoutes.js

@@ -1,126 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RESTApiRoutes = void 0;
-const WebAppMeta_1 = require("./WebAppMeta");
-const http_api_1 = require("@webpieces/http-api");
-const decorators_1 = require("./decorators");
-/**
- * RESTApiRoutes - Automatically wire API interfaces to controllers.
- * Similar to Java WebPieces RESTApiRoutes.
- *
- * This class uses reflection (reflect-metadata) to read decorators from
- * an API interface class and automatically register routes that dispatch
- * to the corresponding controller methods.
- *
- * Usage:
- * ```typescript
- * // In your ServerMeta:
- * getRoutes(): Routes[] {
- *   return [
- *     new RESTApiRoutes(SaveApiPrototype, SaveController),
- *     // ... more routes
- *   ];
- * }
- * ```
- *
- * The API interface and controller must follow this pattern:
- * - API interface class has @ApiInterface() decorator
- * - Methods have @Post()/@Get()/etc and @Path() decorators
- * - Controller class implements the same interface
- * - Controller class has @Controller() decorator
- *
- * Type Parameters:
- * - TApi: The API prototype class type (abstract class with decorators)
- * - TController: The controller class type (must extend TApi)
- */
-class RESTApiRoutes {
-    /**
-     * Create a new RESTApiRoutes.
-     *
-     * @param apiMetaClass - The API interface class with decorators (e.g., SaveApiPrototype)
-     * @param controllerClass - The controller class that implements the API (e.g., SaveController)
-     */
-    constructor(apiMetaClass, controllerClass) {
-        this.apiMetaClass = apiMetaClass;
-        this.controllerClass = controllerClass;
-        // Validate that apiMetaClass is marked as @ApiInterface
-        if (!(0, http_api_1.isApiInterface)(apiMetaClass)) {
-            const className = apiMetaClass.name || 'Unknown';
-            throw new Error(`Class ${className} must be decorated with @ApiInterface()`);
-        }
-        // Validate that controllerClass implements the methods from apiMetaClass
-        this.validateControllerImplementsApi();
-    }
-    /**
-     * Validate that the controller implements all methods from the API interface.
-     */
-    validateControllerImplementsApi() {
-        const routes = (0, http_api_1.getRoutes)(this.apiMetaClass);
-        for (const route of routes) {
-            const controllerPrototype = this.controllerClass.prototype;
-            if (typeof controllerPrototype[route.methodName] !== 'function') {
-                const controllerName = this.controllerClass.name || 'Unknown';
-                const apiName = this.apiMetaClass.name || 'Unknown';
-                throw new Error(`Controller ${controllerName} must implement method ${route.methodName} from API ${apiName}`);
-            }
-        }
-    }
-    /**
-     * Configure routes by reading metadata from the API interface.
-     */
-    configure(routeBuilder) {
-        const routes = (0, http_api_1.getRoutes)(this.apiMetaClass);
-        for (const route of routes) {
-            this.registerRoute(routeBuilder, route);
-        }
-    }
-    /**
-     * Register a single route with the route builder.
-     */
-    registerRoute(routeBuilder, route) {
-        if (!route.httpMethod || !route.path) {
-            const apiName = this.apiMetaClass.name || 'Unknown';
-            throw new Error(`Method ${route.methodName} in ${apiName} must have both @HttpMethod and @Path decorators`);
-        }
-        // Set controller class name for logging
-        route.controllerClassName = this.controllerClass.name;
-        // Extract controller filepath for filter matching
-        const controllerFilepath = this.getControllerFilepath();
-        // Pass controller class and method name to RouteBuilder
-        // RouteBuilder will resolve the controller from DI and create the handler
-        routeBuilder.addRoute(new WebAppMeta_1.RouteDefinition(route, this.controllerClass, controllerFilepath));
-    }
-    /**
-     * Get the filepath of the controller source file.
-     * Uses a heuristic based on the controller class name.
-     *
-     * Since TypeScript doesn't provide source file paths at runtime,
-     * we use the class name to create a pattern that filters can match against.
-     *
-     * @returns Filepath pattern or undefined
-     */
-    getControllerFilepath() {
-        // Check for explicit @SourceFile decorator metadata
-        const filepath = Reflect.getMetadata(decorators_1.ROUTING_METADATA_KEYS.SOURCE_FILEPATH, this.controllerClass);
-        if (filepath) {
-            return filepath;
-        }
-        // Fallback to class name pattern
-        const className = this.controllerClass.name;
-        return className ? `**/${className}.ts` : undefined;
-    }
-    /**
-     * Get the API interface class.
-     */
-    getApiClass() {
-        return this.apiMetaClass;
-    }
-    /**
-     * Get the controller class.
-     */
-    getControllerClass() {
-        return this.controllerClass;
-    }
-}
-exports.RESTApiRoutes = RESTApiRoutes;
-//# sourceMappingURL=RESTApiRoutes.js.map

package/src/RESTApiRoutes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RESTApiRoutes.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/RESTApiRoutes.ts"],"names":[],"mappings":"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","sourcesContent":["import { Routes, RouteBuilder, RouteDefinition } from './WebAppMeta';\nimport { getRoutes, isApiInterface, RouteMetadata } from '@webpieces/http-api';\nimport { ROUTING_METADATA_KEYS } from './decorators';\n\n/**\n * Type representing a class constructor (abstract or concrete).\n */\nexport type ClassType<T = any> = Function & { prototype: T };\n\n/**\n * RESTApiRoutes - Automatically wire API interfaces to controllers.\n * Similar to Java WebPieces RESTApiRoutes.\n *\n * This class uses reflection (reflect-metadata) to read decorators from\n * an API interface class and automatically register routes that dispatch\n * to the corresponding controller methods.\n *\n * Usage:\n * ```typescript\n * // In your ServerMeta:\n * getRoutes(): Routes[] {\n *   return [\n *     new RESTApiRoutes(SaveApiPrototype, SaveController),\n *     // ... more routes\n *   ];\n * }\n * ```\n *\n * The API interface and controller must follow this pattern:\n * - API interface class has @ApiInterface() decorator\n * - Methods have @Post()/@Get()/etc and @Path() decorators\n * - Controller class implements the same interface\n * - Controller class has @Controller() decorator\n *\n * Type Parameters:\n * - TApi: The API prototype class type (abstract class with decorators)\n * - TController: The controller class type (must extend TApi)\n */\nexport class RESTApiRoutes<TApi = any, TController extends TApi = any> implements Routes {\n    private apiMetaClass: ClassType<TApi>;\n    private controllerClass: ClassType<TController>;\n\n    /**\n     * Create a new RESTApiRoutes.\n     *\n     * @param apiMetaClass - The API interface class with decorators (e.g., SaveApiPrototype)\n     * @param controllerClass - The controller class that implements the API (e.g., SaveController)\n     */\n    constructor(apiMetaClass: ClassType<TApi>, controllerClass: ClassType<TController>) {\n        this.apiMetaClass = apiMetaClass;\n        this.controllerClass = controllerClass;\n\n        // Validate that apiMetaClass is marked as @ApiInterface\n        if (!isApiInterface(apiMetaClass)) {\n            const className = (apiMetaClass as any).name || 'Unknown';\n            throw new Error(`Class ${className} must be decorated with @ApiInterface()`);\n        }\n\n        // Validate that controllerClass implements the methods from apiMetaClass\n        this.validateControllerImplementsApi();\n    }\n\n    /**\n     * Validate that the controller implements all methods from the API interface.\n     */\n    private validateControllerImplementsApi(): void {\n        const routes = getRoutes(this.apiMetaClass);\n\n        for (const route of routes) {\n            const controllerPrototype = this.controllerClass.prototype;\n\n            if (typeof controllerPrototype[route.methodName] !== 'function') {\n                const controllerName = (this.controllerClass as any).name || 'Unknown';\n                const apiName = (this.apiMetaClass as any).name || 'Unknown';\n                throw new Error(\n                    `Controller ${controllerName} must implement method ${route.methodName} from API ${apiName}`,\n                );\n            }\n        }\n    }\n\n    /**\n     * Configure routes by reading metadata from the API interface.\n     */\n    configure(routeBuilder: RouteBuilder): void {\n        const routes = getRoutes(this.apiMetaClass);\n\n        for (const route of routes) {\n            this.registerRoute(routeBuilder, route);\n        }\n    }\n\n    /**\n     * Register a single route with the route builder.\n     */\n    private registerRoute(routeBuilder: RouteBuilder, route: RouteMetadata): void {\n        if (!route.httpMethod || !route.path) {\n            const apiName = (this.apiMetaClass as any).name || 'Unknown';\n            throw new Error(\n                `Method ${route.methodName} in ${apiName} must have both @HttpMethod and @Path decorators`,\n            );\n        }\n\n        // Set controller class name for logging\n        route.controllerClassName = (this.controllerClass as any).name;\n\n        // Extract controller filepath for filter matching\n        const controllerFilepath = this.getControllerFilepath();\n\n        // Pass controller class and method name to RouteBuilder\n        // RouteBuilder will resolve the controller from DI and create the handler\n        routeBuilder.addRoute(new RouteDefinition(route, this.controllerClass, controllerFilepath));\n    }\n\n    /**\n     * Get the filepath of the controller source file.\n     * Uses a heuristic based on the controller class name.\n     *\n     * Since TypeScript doesn't provide source file paths at runtime,\n     * we use the class name to create a pattern that filters can match against.\n     *\n     * @returns Filepath pattern or undefined\n     */\n    private getControllerFilepath(): string | undefined {\n        // Check for explicit @SourceFile decorator metadata\n        const filepath = Reflect.getMetadata(\n            ROUTING_METADATA_KEYS.SOURCE_FILEPATH,\n            this.controllerClass,\n        );\n        if (filepath) {\n            return filepath;\n        }\n\n        // Fallback to class name pattern\n        const className = (this.controllerClass as any).name;\n        return className ? `**/${className}.ts` : undefined;\n    }\n\n    /**\n     * Get the API interface class.\n     */\n    getApiClass(): any {\n        return this.apiMetaClass;\n    }\n\n    /**\n     * Get the controller class.\n     */\n    getControllerClass(): any {\n        return this.controllerClass;\n    }\n}\n"]}