@rapidrest/service-core 1.0.0-beta.1

package/dist/lib/routes/RouteUtils.js

@@ -0,0 +1,445 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz. All rights reserved.
+///////////////////////////////////////////////////////////////////////////////
+import { ApiError, ObjectDecorators, UserUtils } from "@rapidrest/core";
+import { ServerResponse } from "http";
+import { OpenApiSpec } from "../OpenApiSpec.js";
+import { ApiErrorMessages, ApiErrors } from "../ApiErrors.js";
+import { ACLUtils } from "../security/index.js";
+import _ from "lodash";
+import { AuthMiddleware } from "../auth/AuthMiddleware.js";
+const { Config, Inject, Logger } = ObjectDecorators;
+/**
+ * Provides a set of utilities for converting Route classes to HTTP middleware.
+ *
+ * @author Jean-Philippe Steinmetz <rapidrests@gmail.com>
+ */
+export class RouteUtils {
+    constructor() {
+        this.apiSpec = new OpenApiSpec();
+    }
+    /**
+     * Creates a middleware function that verifies the incoming request is from a valid user with at least
+     * one of the specified roles.
+     */
+    checkRequiredPerms(aclUid) {
+        return async (req, _res, next) => {
+            let granted = this.aclUtils ? await this.aclUtils.checkRequestPerms(aclUid, req.user, req) : false;
+            if (granted) {
+                return next();
+            }
+            else {
+                const err = new ApiError(ApiErrors.AUTH_PERMISSION_FAILURE, 403, ApiErrorMessages.AUTH_PERMISSION_FAILURE);
+                return next(err);
+            }
+        };
+    }
+    /**
+     * Creates a middleware function that verifies the incoming request is from a valid user with at least
+     * one of the specified roles.
+     *
+     * @param requiredRoles The list of roles that the authenticated user must have.
+     */
+    checkRequiredRoles(requiredRoles) {
+        return (req, _res, next) => {
+            let foundRole = UserUtils.hasRoles(req.user, requiredRoles);
+            if (foundRole) {
+                return next();
+            }
+            else {
+                const err = new ApiError(ApiErrors.AUTH_PERMISSION_FAILURE, 403, ApiErrorMessages.AUTH_PERMISSION_FAILURE);
+                return next(err);
+            }
+        };
+    }
+    /**
+     * Converts the given array of string or Function objects to functions bound to the given route object.
+     *
+     * @param route The route object that the list of functions is bound to.
+     * @param funcs The array of functions (or function names) to return.
+     * @param send Set to true to have the last wrapped function send its payload to the client.
+     * @returns An array of Function objects mapping to the route object.
+     */
+    getFuncArray(route, funcs, send = false) {
+        const result = [];
+        if (funcs) {
+            for (let i = 0; i < funcs.length; i++) {
+                const func = funcs[i];
+                if (typeof func == "string") {
+                    result.push(this.wrapMiddleware(route, route[func], send && i >= funcs.length - 1));
+                }
+                else {
+                    result.push(this.wrapMiddleware(route, func, send && i >= funcs.length - 1));
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Searches an route object for any functions that implement a `@Method` decorator.
+     *
+     * @param route The route object to search.
+     * @returns The list of `@Method` decorated functions that were found.
+     */
+    getRouteMethods(route) {
+        let results = new Map();
+        for (let member in route) {
+            let metadata = Reflect.getMetadata("rrst:route", route, member);
+            if (metadata) {
+                results.set(member, route[member]);
+            }
+        }
+        let proto = Object.getPrototypeOf(route);
+        while (proto) {
+            for (let member of Object.getOwnPropertyNames(proto)) {
+                let metadata = Reflect.getMetadata("rrst:route", proto, member);
+                if (metadata) {
+                    results.set(member, route[member]);
+                }
+            }
+            proto = Object.getPrototypeOf(proto);
+        }
+        return results;
+    }
+    /**
+     * Registers the provided route object containing a set of decorated endpoints to the server.
+     *
+     * @param app The HTTP application/router to register the route to.
+     * @param route The route object to register.
+     */
+    async registerRoute(app, route) {
+        let routePaths = Reflect.getMetadata("rrst:routePaths", route);
+        if (!routePaths) {
+            throw new Error("Route must specify a path: " + JSON.stringify(route));
+        }
+        // Check if this route defines a class level ACL. If so, we need to store it and then add middleware to validate
+        // against it.
+        let defaultAcl = Reflect.getMetadata("rrst:acl", route);
+        if (defaultAcl && this.aclUtils) {
+            try {
+                defaultAcl = await this.aclUtils.saveDefaultACL(defaultAcl);
+            }
+            catch (err) {
+                this.logger.info(`Failed to save default ACL for: ${defaultAcl?.uid}`);
+            }
+        }
+        // Each route definition will contain a set of functions that have been decorated to include route metadata.
+        // The route metadata will include what HTTP methods and paths that the endpoint is to be bound to. Multiple
+        // methods and paths can be assigned to a single decorated function. Therefore, it is necessary to register
+        // each combination of basePath, path and method that have been defined by the decorators.
+        let methods = this.getRouteMethods(route);
+        for (let entry of methods.entries()) {
+            let key = entry[0];
+            let value = entry[1];
+            let docs = Reflect.getMetadata("rrst:docs", route, key) || {};
+            let metadata = Reflect.getMetadata("rrst:route", route, key) || {};
+            if (value && metadata) {
+                let { authRequired } = metadata;
+                const { after, before, methods, requiredRoles, validator } = metadata;
+                let { authStrategies } = metadata;
+                let verbMap = methods;
+                // If no JWT strategies have been provided by default, always include JWT token support
+                if (!authStrategies) {
+                    authStrategies = ["jwt"];
+                }
+                // Does this endpoint have an associated ACL?
+                let acl = Reflect.getMetadata("rrst:acl", route, key);
+                if (acl && this.aclUtils) {
+                    acl.parentUid = defaultAcl?.uid;
+                    acl = await this.aclUtils.saveDefaultACL(acl);
+                }
+                // Prepare the list of middleware to apply for the given endpoint.
+                // The order of operations for middleware is:
+                // 1. Auth Strategies
+                // 2. Required Roles
+                // 3. Required Permissions (Path Matching)
+                // 4. Validator Function
+                // 5. Before Functions
+                // 6. Decorated Function
+                // 7. After Functions
+                let middleware = new Array();
+                if (requiredRoles) {
+                    middleware.push(this.checkRequiredRoles(requiredRoles));
+                }
+                const aclUid = acl?.uid || defaultAcl?.uid;
+                if (aclUid) {
+                    middleware.push(this.checkRequiredPerms(aclUid));
+                }
+                if (validator) {
+                    middleware = middleware.concat(this.getFuncArray(route, [validator]));
+                }
+                middleware = middleware.concat(this.getFuncArray(route, before));
+                middleware.push(this.wrapMiddleware(route, value, after === undefined));
+                middleware = middleware.concat(this.getFuncArray(route, after, true));
+                // Multiple method verbs can be registered for a given route endpoint.
+                for (let entry of verbMap.entries()) {
+                    let verb = entry[0];
+                    // Multiple base paths can be provided to a single route definition.
+                    for (let basePath of routePaths) {
+                        let subpath = entry[1].startsWith("/") ? entry[1].substring(1) : entry[1];
+                        let path = subpath.length === 0 || basePath.endsWith("/")
+                            ? basePath + subpath
+                            : basePath + "/" + subpath;
+                        // If the verb is `ws` we need to translate this accordingly
+                        if (verb === "ws") {
+                            // Pre-upgrade auth: runs synchronously in the uWS upgrade callback
+                            // before the WebSocket handshake. Clients that send an Authorization
+                            // header (native apps, etc.) are authenticated here and skip the
+                            // post-upgrade LOGIN message. Browsers that cannot send custom headers
+                            // fall through to the message-based authWebSocket flow.
+                            const upgradeAuth = (req) => {
+                                if (this.authMiddleware) {
+                                    try {
+                                        const result = this.authMiddleware.authenticate(authStrategies, req, undefined, false);
+                                        if (result && !(result instanceof Promise)) {
+                                            return result;
+                                        }
+                                    }
+                                    catch (err) {
+                                        return { reject: true };
+                                    }
+                                }
+                                // No token — fall through to post-upgrade message-based auth
+                                return {};
+                            };
+                            if (this.authMiddleware) {
+                                middleware.unshift(this.authMiddleware.authWebSocket(authRequired));
+                            }
+                            // Set authRequired to false since we enforce it in the authWebSocket function
+                            authRequired = false;
+                            // Register with the HttpRouter's ws() method; trailing slash handled internally
+                            app.ws(path, middleware, undefined, upgradeAuth);
+                            // Update our OpenAPI spec — WebSocket upgrade is a GET request
+                            this.apiSpec.addRoute(key, path, "get", metadata, docs, route);
+                            this.logger.info("Registered Route: WS " + path);
+                            continue;
+                        }
+                        // Build the auth middleware for this route
+                        if (authStrategies && authStrategies.length > 0) {
+                            // Required auth — reject with 401 if no valid authentication
+                            const authMw = async (req, _res, next) => {
+                                try {
+                                    let result = this.authMiddleware?.authenticate(authStrategies, req, authRequired);
+                                    if (result instanceof Promise) {
+                                        result = await result;
+                                    }
+                                    req.auth = result;
+                                    if (!result && authRequired) {
+                                        next(new ApiError(ApiErrors.AUTH_FAILED, 401, ApiErrorMessages.AUTH_FAILED));
+                                        return;
+                                    }
+                                    next();
+                                }
+                                catch (err) {
+                                    if (authRequired) {
+                                        next(new ApiError(ApiErrors.AUTH_FAILED, 401, err.message));
+                                    }
+                                    else {
+                                        next();
+                                    }
+                                }
+                            };
+                            app[verb](path, authMw, ...middleware);
+                        }
+                        else {
+                            app[verb](path, ...middleware);
+                        }
+                        this.logger.info("Registered Route: " + verb.toUpperCase() + " " + path);
+                        // Update our OpenAPI spec object with the details of this route.
+                        this.apiSpec.addRoute(key, path, verb, metadata, docs, route);
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Wraps the provided function with HTTP handling based on the function's defined decorators.
+     *
+     * @param obj The bound object whose middleware function will be wrapped.
+     * @param func The decorated function to wrap.
+     * @param send Set to true to have `func`'s result sent to the client.
+     */
+    wrapMiddleware(obj, func, send = false) {
+        return async (req, res, next) => {
+            try {
+                const argMetadata = Reflect.getMetadata("rrst:args", Object.getPrototypeOf(obj), func.name);
+                const routeMetadata = Reflect.getMetadata("rrst:route", Object.getPrototypeOf(obj), func.name);
+                const args = [];
+                const routeType = [...(routeMetadata?.methods?.keys() || [])][0];
+                // this.logger.debug(`Arg metadata: ${JSON.stringify(argMetadata)}`);
+                // this.logger.debug(`Route metadata: ${JSON.stringify(routeMetadata)}`);
+                // this.logger.debug(`Route type: ${JSON.stringify(routeType)}`);
+                // This is a hack that lets us stub out function arguments because we no longer can access
+                // them directly with func.arguments. Unfortunately this means we can't get default values
+                // as there's no way to reference them. =(
+                for (let i = 0; i < func.length; i++) {
+                    args.push(undefined);
+                }
+                // Populate the list of function arguments based on the metadata
+                if (argMetadata) {
+                    for (const key in argMetadata) {
+                        const i = Number(key);
+                        if (argMetadata[i][0] === "authResult") {
+                            args[i] = req.auth;
+                        }
+                        else if (argMetadata[i][0] === "header") {
+                            if (argMetadata[i][1]) {
+                                args[i] = req.headers[argMetadata[i][1]];
+                            }
+                            else {
+                                args[i] = req.headers;
+                            }
+                        }
+                        else if (argMetadata[i][0] === "param") {
+                            if (argMetadata[i][1]) {
+                                args[i] = req.params[argMetadata[i][1]];
+                            }
+                            else {
+                                args[i] = req.params;
+                            }
+                        }
+                        else if (argMetadata[i][0] === "query") {
+                            if (argMetadata[i][1]) {
+                                args[i] = req.query[argMetadata[i][1]];
+                            }
+                            else {
+                                args[i] = req.query;
+                            }
+                            const isGetRoute = routeType === "get";
+                            const isHeadRoute = routeType === "head";
+                            // Raw buffer encoded query
+                            const MAX_Q_BYTES = 65536;
+                            if ((isGetRoute || isHeadRoute) && _.has(args[i], "q")) {
+                                const qParam = args[i]["q"];
+                                if (typeof qParam !== "string" || qParam.length > MAX_Q_BYTES) {
+                                    throw new ApiError(ApiErrors.INVALID_REQUEST, 400, "Query parameter 'q' exceeds maximum allowed size.");
+                                }
+                                const bufferJsonString = Buffer.from(qParam, "base64").toString("utf-8");
+                                args[i] = JSON.parse(bufferJsonString);
+                            }
+                        }
+                        else if (argMetadata[i][0] === "request") {
+                            args[i] = req;
+                        }
+                        else if (argMetadata[i][0] === "response") {
+                            args[i] = res;
+                        }
+                        else if (argMetadata[i][0] === "user") {
+                            args[i] = req.auth?.user;
+                        }
+                        else if (argMetadata[i][0] === "socket") {
+                            args[i] =
+                                req.websocket !== undefined ? req.websocket : req.socket;
+                        }
+                    }
+                }
+                // If res.result is defined it means the body has already been processed by another
+                // function.
+                let result = res["result"] ? res["result"] : req.body;
+                // Now add the result obj as a function argument
+                if (result) {
+                    let bodyInjected = false;
+                    // Find the first argument without a decorator and insert the request body
+                    for (let i = 0; i < args.length; i++) {
+                        if (!argMetadata || !argMetadata[i]) {
+                            args[i] = result;
+                            bodyInjected = true;
+                            break;
+                        }
+                    }
+                    // If no undecorated arg could be found inject at the end
+                    if (!bodyInjected) {
+                        args.push(result);
+                    }
+                }
+                // Call the wrapped function
+                const boundFunc = func.bind(obj);
+                result = boundFunc(...args);
+                if (result instanceof Promise) {
+                    // Wait for the real result
+                    result = await result;
+                }
+                // If this is a WebSocket request, mark it as having been handled. This will notify
+                // the WebSocket middleware that the connection is active and shouldn't be closed.
+                if (req.websocket !== undefined) {
+                    req.wsHandled = true;
+                }
+                // If the result is a response we need to return this immediately. We don't return the original response
+                // object because responses are passed by copy, not refernce and so the result will be different.
+                // Also catches UWSResponse returned directly (e.g. doCount returns res.status(200)).
+                const isResponse = result === res || result instanceof ServerResponse || (result && result.headers && result.url);
+                if (isResponse) {
+                    return result.send();
+                }
+                else {
+                    if (send) {
+                        let returnJson = true;
+                        if (routeMetadata &&
+                            routeMetadata.contentType &&
+                            typeof routeMetadata.contentType === "string" &&
+                            routeMetadata.contentType.trim().length !== 0) {
+                            res.setHeader("content-type", routeMetadata.contentType.trim());
+                            returnJson = routeMetadata.contentType.trim().includes("application/json");
+                        }
+                        // If a result was returned set it as the response body, otherwise set the status to NO_CONTENT
+                        if (result !== undefined) {
+                            if (!res.headersSent) {
+                                res.status(200);
+                            }
+                            if (returnJson) {
+                                res.json(result);
+                            }
+                            else {
+                                res.send(result);
+                            }
+                        }
+                        else {
+                            if (!res.headersSent) {
+                                res.status(204);
+                            }
+                        }
+                    }
+                    else {
+                        // Assign result to the response for other handlers to use
+                        res.result = result;
+                    }
+                }
+                if (next) {
+                    return next();
+                }
+                else {
+                    return res.send();
+                }
+            }
+            catch (err) {
+                return next(err);
+            }
+        };
+    }
+}
+__decorate([
+    Inject(ACLUtils),
+    __metadata("design:type", ACLUtils)
+], RouteUtils.prototype, "aclUtils", void 0);
+__decorate([
+    Inject(OpenApiSpec),
+    __metadata("design:type", OpenApiSpec)
+], RouteUtils.prototype, "apiSpec", void 0);
+__decorate([
+    Inject(AuthMiddleware),
+    __metadata("design:type", AuthMiddleware)
+], RouteUtils.prototype, "authMiddleware", void 0);
+__decorate([
+    Logger,
+    __metadata("design:type", Object)
+], RouteUtils.prototype, "logger", void 0);
+//# sourceMappingURL=RouteUtils.js.map

package/dist/lib/routes/RouteUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteUtils.js","sourceRoot":"","sources":["../../../src/routes/RouteUtils.ts"],"names":[],"mappings":"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"}

package/dist/lib/routes/StatusRoute.js

@@ -0,0 +1,55 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz
+///////////////////////////////////////////////////////////////////////////////
+import { Get, Route } from "../decorators/RouteDecorators.js";
+import { Description, Returns, Summary } from "../decorators/DocDecorators.js";
+import { ObjectDecorators } from "@rapidrest/core";
+import { StatusExtraData } from "../models/StatusExtraData.js";
+const { Config, Inject } = ObjectDecorators;
+/**
+ * The `StatusRoute` provides a default `/status` endpoint the returns metadata information about the service such as
+ * name, version.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+let StatusRoute = class StatusRoute {
+    get() {
+        return {
+            name: this.config.get("service_name"),
+            time: new Date().toISOString(),
+            version: this.config.get("version"),
+            ...this.statusExtraData?.data
+        };
+    }
+};
+__decorate([
+    Config(),
+    __metadata("design:type", Object)
+], StatusRoute.prototype, "config", void 0);
+__decorate([
+    Inject(StatusExtraData),
+    __metadata("design:type", Object)
+], StatusRoute.prototype, "statusExtraData", void 0);
+__decorate([
+    Summary("{{serviceName}} servrice and operational status"),
+    Description("Returns information about the service and it's operational status."),
+    Get(),
+    Returns([Object]),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Object)
+], StatusRoute.prototype, "get", null);
+StatusRoute = __decorate([
+    Route("/status")
+], StatusRoute);
+export { StatusRoute };
+//# sourceMappingURL=StatusRoute.js.map

package/dist/lib/routes/StatusRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusRoute.js","sourceRoot":"","sources":["../../../src/routes/StatusRoute.ts"],"names":[],"mappings":";;;;;;;;;AAAA,+EAA+E;AAC/E,kDAAkD;AAClD,+EAA+E;AAC/E,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAAC;AAE5C;;;;;GAKG;AAEI,IAAM,WAAW,GAAjB,MAAM,WAAW;IAYZ,GAAG;QACP,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;YACrC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC9B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;YACnC,GAAG,IAAI,CAAC,eAAe,EAAE,IAAI;SAChC,CAAC;IACN,CAAC;CACJ,CAAA;AAlBW;IADP,MAAM,EAAE;;2CACW;AAGZ;IADP,MAAM,CAAC,eAAe,CAAC;;oDAC6B;AAO7C;IAJP,OAAO,CAAC,iDAAiD,CAAC;IAC1D,WAAW,CAAC,oEAAoE,CAAC;IACjF,GAAG,EAAE;IACL,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;;;;sCAQjB;AAnBQ,WAAW;IADvB,KAAK,CAAC,SAAS,CAAC;GACJ,WAAW,CAoBvB"}

package/dist/lib/routes/index.js

@@ -0,0 +1,7 @@
+export * from "./AdminRoute.js";
+export * from "./MetricsRoute.js";
+export * from "./ModelRoute.js";
+export * from "./OpenAPIRoute.js";
+export * from "./RouteUtils.js";
+export * from "./StatusRoute.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/routes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/routes/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}