@rapidrest/service-core 1.0.0-beta.1

package/dist/lib/routes/ModelRoute.js

@@ -0,0 +1,481 @@
+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 { ModelUtils } from "../models/ModelUtils.js";
+import { RepoUtils } from "../models/RepoUtils.js";
+import { Redis } from "ioredis";
+import { RedisConnection } from "../decorators/DatabaseDecorators.js";
+import { BulkError } from "../BulkError.js";
+import { ApiErrorMessages, ApiErrors } from "../ApiErrors.js";
+import { ApiError, Event, EventUtils, ObjectDecorators } from "@rapidrest/core";
+import { ACLAction } from "../security/AccessControlList.js";
+import { ACLUtils } from "../security/ACLUtils.js";
+import { NotificationUtils } from "../NotificationUtils.js";
+import { NetUtils } from "../NetUtils.js";
+import { ObjectFactory } from "../ObjectFactory.js";
+const { Config, Init, Inject, Logger } = ObjectDecorators;
+/**
+ * The `ModelRoute` is an abstract base class that provides a set of built-in route behavior functions for handling
+ * requests for a given data model that is managed by a persistent datastore.
+ *
+ * Provided behaviors:
+ * * `count` - Counts the number of objects matching the provided set of criteria in the request's query parameters.
+ * * `create` - Adds a new object to the datastore.
+ * * `delete` - Removes an existing object from the datastore.
+ * * `find` - Finds all objects matching the provided set of criteria in the request's query parameters.
+ * * `findById` - Finds a single object with a specified unique identifier.
+ * * `truncate` - Removes all objects from the datastore.
+ * * `update` - Modifies an existing object in the datastore.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class ModelRoute {
+    constructor() {
+        /** The unique identifier of the default ACL for the model type. */
+        this.defaultACLUid = "";
+        /**
+         * The number of previous document versions to store in the database. A negative value indicates storing all
+         * versions, a value of `0` stores no versions.
+         */
+        this.trackChanges = 0;
+        this.trustedRoles = ["admin"];
+    }
+    /**
+     * The class type of the model this route is associated with.
+     */
+    get modelClass() {
+        const clazz = Object.getPrototypeOf(this).constructor;
+        return clazz.modelClass;
+    }
+    /**
+     * Called on server startup to initialize the route with any defaults.
+     */
+    async superInitialize() {
+        if (!this.objectFactory) {
+            throw new Error("objectFactory is not set!");
+        }
+        this.repoUtils = await this.objectFactory.newInstance(this.repoUtilsClass || RepoUtils, {
+            name: this.modelClass.name,
+            initialize: true,
+            args: [this.modelClass],
+        });
+        let defaultAcl = this.repoUtils.getDefaultACL();
+        if (defaultAcl) {
+            this.defaultACLUid = defaultAcl.uid;
+        }
+    }
+    /**
+     * Attempts to retrieve the number of data model objects matching the given set of criteria as specified in the
+     * request `query`. Any results that have been found are set to the `content-length` header of the `res` argument.
+     *
+     * @param options The options to process the request using.
+     */
+    async doCount(options) {
+        if (!this.repoUtils) {
+            throw new ApiError(ApiErrors.INTERNAL_ERROR, 500, ApiErrorMessages.INTERNAL_ERROR);
+        }
+        if (!options.res) {
+            throw new ApiError(ApiErrors.INTERNAL_ERROR, 500, ApiErrorMessages.INTERNAL_ERROR);
+        }
+        const searchQuery = ModelUtils.buildSearchQuery(this.modelClass, this.repoUtils.repo, options.params, options.query, true, options.user);
+        const result = await this.repoUtils.count(searchQuery, {
+            limit: options.query?.limit,
+            page: options.query?.page,
+            productUid: options.params?.productUid || options.query?.productUid,
+            version: options.params?.version || options.query?.version,
+            user: options.user,
+        });
+        options.res.setHeader("content-length", result);
+        return options.res.status(200);
+    }
+    /**
+     * Attempts to store an object provided in `options.req.body` into the datastore. Upon success, sets the newly persisted
+     * object(s) to the `result` property of the `options.res` argument, otherwise sends a `400 BAD REQUEST` response to the
+     * client.
+     *
+     * @param obj The object to store in the database.
+     * @param options The options to process the request using.
+     */
+    async doCreateObject(obj, options) {
+        if (!this.repoUtils) {
+            throw new Error("repoUtils not set!");
+        }
+        // Make sure the provided object has the correct typing
+        let result = this.repoUtils.instantiateObject(obj);
+        result = await this.repoUtils.create(result, options);
+        if (options.recordEvent) {
+            const evt = {
+                type: `Create${this.modelClass.name}`,
+                objectUid: result.uid,
+                userUid: options.user ? options.user.uid : undefined,
+                ip: options.req ? NetUtils.getIPAddress(options.req, this.config?.get("trusted_proxies")) : undefined,
+            };
+            void EventUtils.record(new Event(this.config, options.user ? options.user.uid : "anonymous", evt));
+        }
+        return result;
+    }
+    /**
+     * Attempts to store a collection of objects provided in `options.req.body` into the datastore. Upon success, sets the newly persisted
+     * object(s) to the `result` property of the `options.res` argument, otherwise sends a `400 BAD REQUEST` response to the
+     * client.
+     *
+     * @param objs The object(s) to store in the database.
+     * @param options The options to process the request using.
+     */
+    async doBulkCreate(objs, options) {
+        let thrownError = false;
+        const errors = [];
+        const results = [];
+        for (const obj of objs) {
+            try {
+                results.push(await this.doCreateObject(obj, options));
+                errors.push(null);
+            }
+            catch (err) {
+                errors.push(err);
+                thrownError = true;
+            }
+        }
+        if (thrownError) {
+            throw new BulkError(errors, ApiErrors.BULK_CREATE_FAILURE, 400, ApiErrorMessages.BULK_CREATE_FAILURE);
+        }
+        return results;
+    }
+    /**
+     * Attempts to store one or more objects provided in `options.req.body` into the datastore. Upon success, sets the newly persisted
+     * object(s) to the `result` property of the `options.res` argument, otherwise sends a `400 BAD REQUEST` response to the
+     * client.
+     *
+     * @param obj The object(s) to store in the database.
+     * @param options The options to process the request using.
+     */
+    async doCreate(obj, options) {
+        if (!(await this.aclUtils?.hasPermission(options.user, this.defaultACLUid, ACLAction.CREATE))) {
+            throw new ApiError(ApiErrors.AUTH_PERMISSION_FAILURE, 403, ApiErrorMessages.AUTH_PERMISSION_FAILURE);
+        }
+        if (Array.isArray(obj)) {
+            return await this.doBulkCreate(obj, {
+                ...options,
+                ignoreACL: true,
+            });
+        }
+        else {
+            return await this.doCreateObject(obj, {
+                ...options,
+                ignoreACL: true,
+            });
+        }
+    }
+    /**
+     * Attempts to delete an existing data model object with a given unique identifier encoded by the URI parameter
+     * `id`.
+     *
+     * @param id The unique identifier of the object to delete.
+     * @param options The options to process the request using.
+     */
+    async doDelete(id, options) {
+        if (!this.repoUtils || !this.repoUtils.repo) {
+            throw new ApiError(ApiErrors.INTERNAL_ERROR, 500, ApiErrorMessages.INTERNAL_ERROR);
+        }
+        // When id === `me` this is a special keyword meaning the authenticated user
+        if (id.toLowerCase() === "me") {
+            if (options.user) {
+                id = options.user.uid;
+            }
+            else {
+                throw new ApiError(ApiErrors.SEARCH_INVALID_ME_REFERENCE, 403, ApiErrorMessages.SEARCH_INVALID_ME_REFERENCE);
+            }
+        }
+        const existing = await this.repoUtils.findOne(id, {
+            productUid: options.productUid,
+            version: options.version,
+        });
+        if (!existing) {
+            throw new ApiError(ApiErrors.NOT_FOUND, 404, ApiErrorMessages.NOT_FOUND);
+        }
+        await this.repoUtils.delete(existing.uid, options);
+        if (options.recordEvent) {
+            const count = await this.repoUtils.repo.count({ uid: existing.uid });
+            const evt = {
+                type: `Delete${this.modelClass.name}`,
+                objectUid: existing.uid,
+                userUid: options.user ? options.user.uid : "anonymous",
+                ip: options.req ? NetUtils.getIPAddress(options.req, this.config?.get("trusted_proxies")) : undefined,
+                purged: count === 0,
+            };
+            void EventUtils.record(new Event(this.config, options.user ? options.user.uid : "anonymous", evt));
+        }
+    }
+    /**
+     * Attempts to determine if an existing object with the given unique identifier exists.
+     *
+     * @param id The unique identifier of the object to verify exists.
+     * @param options The options to process the request using.
+     */
+    async doExists(id, options) {
+        if (!this.repoUtils || !options.res) {
+            throw new ApiError(ApiErrors.INTERNAL_ERROR, 500, ApiErrorMessages.INTERNAL_ERROR);
+        }
+        // When id === `me` this is a special keyword meaning the authenticated user
+        if (id.toLowerCase() === "me") {
+            if (options.user) {
+                id = options.user.uid;
+            }
+            else {
+                throw new ApiError(ApiErrors.SEARCH_INVALID_ME_REFERENCE, 403, ApiErrorMessages.SEARCH_INVALID_ME_REFERENCE);
+            }
+        }
+        // Check user permissions
+        if (this.aclUtils && !options.ignoreACL) {
+            if (!(await this.aclUtils.hasPermission(options.user, this.defaultACLUid, ACLAction.READ))) {
+                throw new ApiError(ApiErrors.AUTH_PERMISSION_FAILURE, 403, ApiErrorMessages.AUTH_PERMISSION_FAILURE);
+            }
+        }
+        const query = this.repoUtils.searchIdQuery(id, options.query.version);
+        const result = await this.repoUtils.count(query);
+        if (result > 0) {
+            return options.res.status(200).setHeader("content-length", result);
+        }
+        else {
+            return options.res.status(404);
+        }
+    }
+    /**
+     * Attempts to retrieve all data model objects matching the given set of criteria as specified in the request
+     * `query`. Any results that have been found are set to the `result` property of the `res` argument. `result` is
+     * never null.
+     *
+     * @param options The options to process the request using.
+     */
+    async doFindAll(options) {
+        if (!this.repoUtils) {
+            throw new ApiError(ApiErrors.INTERNAL_ERROR, 500, ApiErrorMessages.INTERNAL_ERROR);
+        }
+        // Check user permissions
+        if (this.aclUtils && !options.ignoreACL) {
+            if (!(await this.aclUtils.hasPermission(options.user, this.defaultACLUid, ACLAction.READ))) {
+                throw new ApiError(ApiErrors.AUTH_PERMISSION_FAILURE, 403, ApiErrorMessages.AUTH_PERMISSION_FAILURE);
+            }
+        }
+        const searchQuery = ModelUtils.buildSearchQuery(this.modelClass, this.repoUtils.repo, options.params, options.query, true, options.user);
+        return await this.repoUtils.find(searchQuery, {
+            limit: options.query?.limit,
+            page: options.query?.page,
+            productUid: options.params?.productUid || options.query?.productUid,
+            version: options.params?.version || options.query?.version,
+            user: options.user,
+        });
+    }
+    /**
+     * Attempts to retrieve a single data model object as identified by the `id` parameter in the URI.
+     *
+     * @param options The options to process the request using.
+     */
+    async doFindById(id, options) {
+        if (!this.repoUtils) {
+            throw new ApiError(ApiErrors.INTERNAL_ERROR, 500, ApiErrorMessages.INTERNAL_ERROR);
+        }
+        // When id === `me` this is a special keyword meaning the authenticated user
+        if (id.toLowerCase() === "me") {
+            if (options.user) {
+                id = options.user.uid;
+            }
+            else {
+                throw new ApiError(ApiErrors.SEARCH_INVALID_ME_REFERENCE, 403, ApiErrorMessages.SEARCH_INVALID_ME_REFERENCE);
+            }
+        }
+        const result = await this.repoUtils.findOne(id, {
+            productUid: options.params?.productUid || options.query?.productUid,
+            version: options.params?.version || options.query?.version,
+        });
+        if (!result) {
+            throw new ApiError(ApiErrors.NOT_FOUND, 404, ApiErrorMessages.NOT_FOUND);
+        }
+        if (this.aclUtils && !options.ignoreACL) {
+            const acl = await this.aclUtils.findACL(result.uid);
+            if (!(await this.aclUtils.hasPermission(options.user, acl ? acl : this.defaultACLUid, ACLAction.READ))) {
+                throw new ApiError(ApiErrors.AUTH_PERMISSION_FAILURE, 403, ApiErrorMessages.AUTH_PERMISSION_FAILURE);
+            }
+        }
+        return result;
+    }
+    /**
+     * Attempts to remove all entries of the data model type from the datastore matching the given
+     * parameters and query.
+     *
+     * @param options The options to process the request using.
+     */
+    async doTruncate(options) {
+        if (!this.repoUtils) {
+            throw new ApiError(ApiErrors.INTERNAL_ERROR, 500, ApiErrorMessages.INTERNAL_ERROR);
+        }
+        const searchQuery = ModelUtils.buildSearchQuery(this.modelClass, this.repoUtils.repo, options.params, options.query, true, options.user);
+        await this.repoUtils?.truncate(searchQuery, {
+            limit: options.query?.limit,
+            page: options.query?.page,
+            productUid: options.params?.productUid || options.query?.productUid,
+            pushChannels: options.pushChannels,
+            skipPush: options.skipPush,
+            version: options.params?.version || options.query?.version,
+            user: options.user,
+        });
+        if (options.recordEvent) {
+            const evt = {
+                type: `Truncate${this.modelClass.name}`,
+                userUid: options.user ? options.user.uid : "anonymous",
+                ip: options.req ? NetUtils.getIPAddress(options.req, this.config?.get("trusted_proxies")) : undefined,
+            };
+            void EventUtils.record(new Event(this.config, options.user ? options.user.uid : "anonymous", evt));
+        }
+    }
+    /**
+     * Attempts to modify a collection of existing data model objects.
+     *
+     * @param objs The object(s) to bulk update in the database.
+     * @param options The options to process the request using.
+     */
+    async doBulkUpdate(objs, options) {
+        let thrownError = false;
+        const errors = [];
+        const result = [];
+        for (const obj of objs) {
+            try {
+                result.push(await this.doUpdate(obj.uid, obj, options));
+                errors.push(null);
+            }
+            catch (err) {
+                errors.push(err);
+                thrownError = true;
+            }
+        }
+        if (thrownError) {
+            throw new BulkError(errors, ApiErrors.BULK_UPDATE_FAILURE, 400, ApiErrorMessages.BULK_UPDATE_FAILURE);
+        }
+        return result;
+    }
+    /**
+     * Attempts to modify an existing data model object as identified by the `id` parameter in the URI.
+     *
+     * @param obj The object to update in the database
+     * @param options The options to process the request using.
+     */
+    async doUpdate(id, obj, options) {
+        if (!this.repoUtils) {
+            throw new ApiError(ApiErrors.INTERNAL_ERROR, 500, ApiErrorMessages.INTERNAL_ERROR);
+        }
+        // When id === `me` this is a special keyword meaning the authenticated user
+        if (id.toLowerCase() === "me") {
+            if (options.user) {
+                id = options.user.uid;
+            }
+            else {
+                throw new ApiError(ApiErrors.SEARCH_INVALID_ME_REFERENCE, 403, ApiErrorMessages.SEARCH_INVALID_ME_REFERENCE);
+            }
+        }
+        const existing = await this.repoUtils.findOne(id, {
+            productUid: options.productUid || obj.productUid,
+            skipCache: true,
+        });
+        if (!existing) {
+            throw new ApiError(ApiErrors.NOT_FOUND, 404, ApiErrorMessages.NOT_FOUND);
+        }
+        const result = await this.repoUtils.update(obj, existing, options);
+        if (options.recordEvent) {
+            const evt = {
+                type: `Update${this.modelClass.name}`,
+                objectUid: obj.uid,
+                userUid: options.user ? options.user.uid : "anonymous",
+                ip: options.req ? NetUtils.getIPAddress(options.req, this.config?.get("trusted_proxies")) : undefined,
+            };
+            void EventUtils.record(new Event(this.config, options.user ? options.user.uid : "anonymous", evt));
+        }
+        return result;
+    }
+    /**
+     * Attempts to modify a single property of an existing data model object as identified by the `id` parameter in the URI.
+     *
+     * Note that this effectively bypasses optimistic locking and can cause unexpected data overwrites. Use with care.
+     *
+     * @param id The unique identifier of the object to update.
+     * @param propertyName The name of the property to update.
+     * @param value The value of the property to set.
+     * @param options The options to process the request using.
+     */
+    async doUpdateProperty(id, propertyName, value, options) {
+        // When id === `me` this is a special keyword meaning the authenticated user
+        if (id.toLowerCase() === "me") {
+            if (options.user) {
+                id = options.user.uid;
+            }
+            else {
+                throw new ApiError(ApiErrors.SEARCH_INVALID_ME_REFERENCE, 403, ApiErrorMessages.SEARCH_INVALID_ME_REFERENCE);
+            }
+        }
+        const existing = options.existing ||
+            (await this.repoUtils?.findOne(id, {
+                productUid: options.productUid,
+            }));
+        if (!existing) {
+            throw new ApiError(ApiErrors.NOT_FOUND, 404, ApiErrorMessages.NOT_FOUND);
+        }
+        return await this.doUpdate(id, {
+            uid: existing.uid,
+            productUid: options.productUid || "productUid" in existing ? existing.productUid : undefined,
+            version: options.version || "version" in existing ? existing.version : undefined,
+            [propertyName]: value,
+        }, {
+            ...options,
+            existing,
+        });
+    }
+    /**
+     * Calls `repoUtils.validate()` to validate the object(s) provided.
+     */
+    async doValidate(objs, options) {
+        await this.repoUtils?.validate(objs, options);
+    }
+}
+__decorate([
+    Inject(ACLUtils),
+    __metadata("design:type", ACLUtils)
+], ModelRoute.prototype, "aclUtils", void 0);
+__decorate([
+    RedisConnection("cache"),
+    __metadata("design:type", Redis)
+], ModelRoute.prototype, "cacheClient", void 0);
+__decorate([
+    Config(),
+    __metadata("design:type", Object)
+], ModelRoute.prototype, "config", void 0);
+__decorate([
+    Logger,
+    __metadata("design:type", Object)
+], ModelRoute.prototype, "logger", void 0);
+__decorate([
+    Inject(NotificationUtils),
+    __metadata("design:type", NotificationUtils)
+], ModelRoute.prototype, "notificationUtils", void 0);
+__decorate([
+    Inject(ObjectFactory),
+    __metadata("design:type", ObjectFactory)
+], ModelRoute.prototype, "objectFactory", void 0);
+__decorate([
+    Config("trusted_roles", ["admin"]),
+    __metadata("design:type", Array)
+], ModelRoute.prototype, "trustedRoles", void 0);
+__decorate([
+    Init,
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ModelRoute.prototype, "superInitialize", null);
+//# sourceMappingURL=ModelRoute.js.map

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

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

package/dist/lib/routes/OpenAPIRoute.js

@@ -0,0 +1,115 @@
+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 { ObjectDecorators } from "@rapidrest/core";
+import { OpenApiSpec } from "../OpenApiSpec.js";
+import { Description, Returns, Summary } from "../decorators/DocDecorators.js";
+import { Get, Route, ContentType } from "../decorators/RouteDecorators.js";
+const { Inject } = ObjectDecorators;
+/** Inline Swagger UI HTML page — loads swagger-ui-dist from CDN so there is no npm dependency. */
+function swaggerHtml(specUrl) {
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>API Documentation</title>
+  <link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist/swagger-ui.css">
+</head>
+<body>
+  <div id="swagger-ui"></div>
+  <script src="https://unpkg.com/swagger-ui-dist/swagger-ui-bundle.js"></script>
+  <script>
+    SwaggerUIBundle({
+      url: "${specUrl}",
+      dom_id: "#swagger-ui",
+      presets: [SwaggerUIBundle.presets.apis, SwaggerUIBundle.SwaggerUIStandalonePreset],
+      layout: "BaseLayout"
+    });
+  </script>
+</body>
+</html>`;
+}
+/**
+ * The `OpenAPIRoute` provides default routes to expose the service's OpenAPI specification.
+ *
+ * - `GET /` — Swagger UI HTML (loads swagger-ui-dist from CDN)
+ * - `GET /openapi.json` — raw OpenAPI specification as JSON
+ * - `GET /openapi.yaml` — raw OpenAPI specification as YAML
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+let OpenAPIRoute = class OpenAPIRoute {
+    constructor() {
+        /** The underlying OpenAPI specification. */
+        this.apiSpec = new OpenApiSpec();
+    }
+    getHTML() {
+        return swaggerHtml("/openapi.json");
+    }
+    getAPIDocs() {
+        return swaggerHtml("/openapi.json");
+    }
+    getJSON() {
+        return this.apiSpec.getSpec();
+    }
+    getYAML() {
+        return this.apiSpec.getSpecAsYaml();
+    }
+};
+__decorate([
+    Inject(OpenApiSpec),
+    __metadata("design:type", OpenApiSpec)
+], OpenAPIRoute.prototype, "apiSpec", void 0);
+__decorate([
+    Summary("{{serviceName}} OpenAPI, HTLM format"),
+    Description("Returns the OpenAPI specification for the service in HTML format."),
+    Get(),
+    ContentType("text/html"),
+    Returns([String]),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", String)
+], OpenAPIRoute.prototype, "getHTML", null);
+__decorate([
+    Summary("{{serviceName}} API docs"),
+    Description("Returns the OpenAPI specification for the service in HTML format."),
+    Get("api-docs"),
+    ContentType("text/html"),
+    Returns([String]),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", String)
+], OpenAPIRoute.prototype, "getAPIDocs", null);
+__decorate([
+    Summary("{{serviceName}} OpenAPI, JSON format"),
+    Description("Returns the OpenAPI specification for the service in JSON format."),
+    Get("openapi.json"),
+    Returns([String]),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Object)
+], OpenAPIRoute.prototype, "getJSON", null);
+__decorate([
+    Summary("{{serviceName}} OpenAPI, YAML format"),
+    Description("Returns the OpenAPI specification for the service in YAML format."),
+    Get("openapi.yaml"),
+    ContentType("text/yaml"),
+    Returns([String]),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", String)
+], OpenAPIRoute.prototype, "getYAML", null);
+OpenAPIRoute = __decorate([
+    Route("/")
+], OpenAPIRoute);
+export { OpenAPIRoute };
+//# sourceMappingURL=OpenAPIRoute.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAPIRoute.js","sourceRoot":"","sources":["../../../src/routes/OpenAPIRoute.ts"],"names":[],"mappings":";;;;;;;;;AAAA,+EAA+E;AAC/E,kDAAkD;AAClD,+EAA+E;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC3E,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAAC;AAEpC,kGAAkG;AAClG,SAAS,WAAW,CAAC,OAAe;IAChC,OAAO;;;;;;;;;;;;cAYG,OAAO;;;;;;;QAOb,CAAC;AACT,CAAC;AAED;;;;;;;;GAQG;AAEI,IAAM,YAAY,GAAlB,MAAM,YAAY;IAAlB;QACH,4CAA4C;QAEpC,YAAO,GAAgB,IAAI,WAAW,EAAE,CAAC;IAoCrD,CAAC;IA7BU,OAAO;QACV,OAAO,WAAW,CAAC,eAAe,CAAC,CAAC;IACxC,CAAC;IAOM,UAAU;QACb,OAAO,WAAW,CAAC,eAAe,CAAC,CAAC;IACxC,CAAC;IAMM,OAAO;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAClC,CAAC;IAOM,OAAO;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IACxC,CAAC;CACJ,CAAA;AApCW;IADP,MAAM,CAAC,WAAW,CAAC;8BACH,WAAW;6CAAqB;AAO1C;IALN,OAAO,CAAC,sCAAsC,CAAC;IAC/C,WAAW,CAAC,mEAAmE,CAAC;IAChF,GAAG,EAAE;IACL,WAAW,CAAC,WAAW,CAAC;IACxB,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;;;;2CAGjB;AAOM;IALN,OAAO,CAAC,0BAA0B,CAAC;IACnC,WAAW,CAAC,mEAAmE,CAAC;IAChF,GAAG,CAAC,UAAU,CAAC;IACf,WAAW,CAAC,WAAW,CAAC;IACxB,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;;;;8CAGjB;AAMM;IAJN,OAAO,CAAC,sCAAsC,CAAC;IAC/C,WAAW,CAAC,mEAAmE,CAAC;IAChF,GAAG,CAAC,cAAc,CAAC;IACnB,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;;;;2CAGjB;AAOM;IALN,OAAO,CAAC,sCAAsC,CAAC;IAC/C,WAAW,CAAC,mEAAmE,CAAC;IAChF,GAAG,CAAC,cAAc,CAAC;IACnB,WAAW,CAAC,WAAW,CAAC;IACxB,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;;;;2CAGjB;AAtCQ,YAAY;IADxB,KAAK,CAAC,GAAG,CAAC;GACE,YAAY,CAuCxB"}