axe-api 0.30.2 → 0.31.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Release Notes
 
+## [0.31.0 (2023-05-05)](https://github.com/axe-api/axe-api/compare/0.31.0...0.30.3)
+
+### Features
+
+- Added new auto-created documentation values [#179](https://github.com/axe-api/axe-api/issues/179)
+
+### Fixed
+
+- Fixed PostgreSQL-related issues [#204](https://github.com/axe-api/axe-api/issues/204)
+
+## [0.30.3 (2023-05-05)](https://github.com/axe-api/axe-api/compare/0.30.3...0.30.2)
+
+### Fixed
+
+- Fixed security issues on dependencies.
+
 ## [0.30.2 (2023-04-18)](https://github.com/axe-api/axe-api/compare/0.30.2...0.30.1)
 
 ### Features
@@ -10,7 +26,7 @@
 
 ### Fixed
 
-- Fixed URL slash character difference between windows and *nix [#164](https://github.com/axe-api/axe-api/issues/164)
+- Fixed URL slash character difference between windows and \*nix [#164](https://github.com/axe-api/axe-api/issues/164)
 
 ## [0.30.0 (2023-04-05)](https://github.com/axe-api/axe-api/compare/0.30.0...0.22.0)
 

package/build/src/Builders/RouterBuilder.js

@@ -126,40 +126,42 @@ class RouterBuilder {
             const docs = Services_1.DocumentationService.getInstance();
             const app = yield Services_1.IoCService.useByType("App");
             const handler = (req, res) => {
-                this.requestHandler(handlerType, req, res, model, parentModel, relation);
+                this.requestHandler(handlerType, req, res, model, parentModel, relation).catch((error) => {
+                    this.sendErrorAsResponse(res, error);
+                });
             };
             switch (handlerType) {
                 case Enums_1.HandlerTypes.ALL:
                     app.get(url, middlewares, handler);
-                    docs.push(Enums_1.HttpMethods.GET, url, model);
+                    docs.push(this.version, Enums_1.HandlerTypes.ALL, Enums_1.HttpMethods.GET, url, model);
                     break;
                 case Enums_1.HandlerTypes.DELETE:
                     app.delete(url, middlewares, handler);
-                    docs.push(Enums_1.HttpMethods.DELETE, url, model);
+                    docs.push(this.version, Enums_1.HandlerTypes.DELETE, Enums_1.HttpMethods.DELETE, url, model);
                     break;
                 case Enums_1.HandlerTypes.FORCE_DELETE:
                     app.delete(url, middlewares, handler);
-                    docs.push(Enums_1.HttpMethods.DELETE, url, model);
+                    docs.push(this.version, Enums_1.HandlerTypes.FORCE_DELETE, Enums_1.HttpMethods.DELETE, url, model);
                     break;
                 case Enums_1.HandlerTypes.INSERT:
                     app.post(url, middlewares, handler);
-                    docs.push(Enums_1.HttpMethods.POST, url, model);
+                    docs.push(this.version, Enums_1.HandlerTypes.INSERT, Enums_1.HttpMethods.POST, url, model);
                     break;
                 case Enums_1.HandlerTypes.PAGINATE:
                     app.get(url, middlewares, handler);
-                    docs.push(Enums_1.HttpMethods.GET, url, model);
+                    docs.push(this.version, Enums_1.HandlerTypes.PAGINATE, Enums_1.HttpMethods.GET, url, model);
                     break;
                 case Enums_1.HandlerTypes.PATCH:
                     app.patch(url, middlewares, handler);
-                    docs.push(Enums_1.HttpMethods.PATCH, url, model);
+                    docs.push(this.version, Enums_1.HandlerTypes.PATCH, Enums_1.HttpMethods.PATCH, url, model);
                     break;
                 case Enums_1.HandlerTypes.SHOW:
                     app.get(url, middlewares, handler);
-                    docs.push(Enums_1.HttpMethods.GET, url, model);
+                    docs.push(this.version, Enums_1.HandlerTypes.SHOW, Enums_1.HttpMethods.GET, url, model);
                     break;
                 case Enums_1.HandlerTypes.UPDATE:
                     app.put(url, middlewares, handler);
-                    docs.push(Enums_1.HttpMethods.PUT, url, model);
+                    docs.push(this.version, Enums_1.HandlerTypes.UPDATE, Enums_1.HttpMethods.PUT, url, model);
                     break;
                 default:
                     throw new Error("Undefined handler type");

package/build/src/Handlers/DestroyHandler.js

@@ -17,9 +17,13 @@ const Enums_1 = require("../Enums");
 const ApiError_1 = __importDefault(require("../Exceptions/ApiError"));
 exports.default = (pack) => __awaiter(void 0, void 0, void 0, function* () {
     const { model, req, res, database, relation, parentModel } = pack;
+    // We should check the parameter type
+    const value = req.params[model.instance.primaryKey];
+    (0, Helpers_1.checkPrimaryKeyValueType)(model, value);
+    // Adding the main query
     const query = database
         .from(model.instance.table)
-        .where(model.instance.primaryKey, req.params[model.instance.primaryKey]);
+        .where(model.instance.primaryKey, value);
     // If there is a deletedAtColumn, it means that this table support soft-delete
     (0, Helpers_1.addSoftDeleteQuery)(model, null, query);
     // If there is a relation, we should bind it

package/build/src/Handlers/DocsHTMLHandler.js

@@ -0,0 +1,24 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const CLOUD_FRONT_DOMAIN = "https://dw7lgbuj348m4.cloudfront.net/v1";
+exports.default = (req, res) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        const result = yield fetch(`${CLOUD_FRONT_DOMAIN}/index.html`);
+        const content = (yield result.text())
+            .replaceAll(`src="`, `src="${CLOUD_FRONT_DOMAIN}`)
+            .replaceAll(`href="`, `href="${CLOUD_FRONT_DOMAIN}`);
+        res.send(content);
+    }
+    catch (error) {
+        res.send("404");
+    }
+});

package/build/src/Handlers/ForceDestroyHandler.js

@@ -17,9 +17,13 @@ const Enums_1 = require("../Enums");
 const ApiError_1 = __importDefault(require("../Exceptions/ApiError"));
 exports.default = (pack) => __awaiter(void 0, void 0, void 0, function* () {
     const { model, req, res, database, relation, parentModel } = pack;
+    // We should check the parameter type
+    const value = req.params[model.instance.primaryKey];
+    (0, Helpers_1.checkPrimaryKeyValueType)(model, value);
+    // Adding the main query
     const query = database
         .from(model.instance.table)
-        .where(model.instance.primaryKey, req.params[model.instance.primaryKey]);
+        .where(model.instance.primaryKey, value);
     // If there is a deletedAtColumn, it means that this table support soft-delete
     if (model.instance.deletedAtColumn === null) {
         throw new ApiError_1.default("You can use force delete only soft-delete supported models.");

package/build/src/Handlers/Helpers.d.ts

@@ -9,6 +9,7 @@ export declare const bindTimestampValues: (formData: Record<string, any>, column
 export declare const getMergedFormData: (req: Request, fillables: string[]) => Record<string, any>;
 export declare const callHooks: (model: IModelService, type: HookFunctionTypes, params: IHookParameter) => Promise<void>;
 export declare const getParentColumn: (relation: IRelation | null) => string | null;
+export declare const checkPrimaryKeyValueType: (model: IModelService, value: any) => void;
 export declare const addForeignKeyQuery: (request: Request, query: Knex.QueryBuilder, relation: IRelation | null, parentModel: IModelService | null) => void;
 export declare const serializeData: (version: IVersion, itemArray: any[] | any, modelSerializer: SerializationFunction | null, handler: HandlerTypes, request: Request) => Promise<any[]>;
 export declare const filterHiddenFields: (itemArray: any[], hiddens: string[] | null) => void;

package/build/src/Handlers/Helpers.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isBoolean = exports.getRelatedData = exports.addSoftDeleteQuery = exports.filterHiddenFields = exports.serializeData = exports.addForeignKeyQuery = exports.getParentColumn = exports.callHooks = exports.getMergedFormData = exports.bindTimestampValues = void 0;
+exports.isBoolean = exports.getRelatedData = exports.addSoftDeleteQuery = exports.filterHiddenFields = exports.serializeData = exports.addForeignKeyQuery = exports.checkPrimaryKeyValueType = exports.getParentColumn = exports.callHooks = exports.getMergedFormData = exports.bindTimestampValues = void 0;
 const change_case_1 = require("change-case");
 const Enums_1 = require("../Enums");
 const ApiError_1 = __importDefault(require("../Exceptions/ApiError"));
@@ -63,6 +63,14 @@ const getParentColumn = (relation) => {
     return (0, change_case_1.camelCase)(relation.foreignKey);
 };
 exports.getParentColumn = getParentColumn;
+const checkPrimaryKeyValueType = (model, value) => {
+    // We should check the parameter type
+    const primaryColumn = model.columns.find((column) => column.name === model.instance.primaryKey);
+    if ((primaryColumn === null || primaryColumn === void 0 ? void 0 : primaryColumn.data_type) === "integer" && isNaN(parseInt(value))) {
+        throw new ApiError_1.default(`Unacceptable parameter: ${value}`);
+    }
+};
+exports.checkPrimaryKeyValueType = checkPrimaryKeyValueType;
 const addForeignKeyQuery = (request, query, relation, parentModel) => {
     if (relation && parentModel) {
         const parentColumn = (0, exports.getParentColumn)(relation);

package/build/src/Handlers/MetadataHandler.d.ts

@@ -0,0 +1,3 @@
+import { Request, Response } from "express";
+declare const _default: (req: Request, res: Response) => Promise<void>;
+export default _default;

package/build/src/Handlers/PatchHandler.js

@@ -24,9 +24,11 @@ exports.default = (pack) => __awaiter(void 0, void 0, void 0, function* () {
     // If there is a deletedAtColumn, it means that this table support soft-delete
     (0, Helpers_1.addSoftDeleteQuery)(model, null, query);
     yield (0, Helpers_1.callHooks)(model, Enums_1.HookFunctionTypes.onBeforeUpdateQuery, Object.assign(Object.assign({}, pack), { query }));
-    let item = yield query
-        .where(model.instance.primaryKey, req.params[model.instance.primaryKey])
-        .first();
+    // We should check the parameter type
+    const value = req.params[model.instance.primaryKey];
+    (0, Helpers_1.checkPrimaryKeyValueType)(model, value);
+    // Adding the main query
+    let item = yield query.where(model.instance.primaryKey, value).first();
     if (!item) {
         throw new ApiError_1.default(`The item is not found on ${model.name}.`);
     }

package/build/src/Handlers/ShowHandler.js

@@ -29,8 +29,11 @@ exports.default = (pack) => __awaiter(void 0, void 0, void 0, function* () {
     queryParser.applyFields(query, conditions.fields);
     // If there is a relation, we should bind it
     (0, Helpers_1.addForeignKeyQuery)(req, query, relation, parentModel);
-    // We should add this condition in here because of performance.
-    query.where(model.instance.primaryKey, req.params[model.instance.primaryKey]);
+    // We should check the parameter type
+    const value = req.params[model.instance.primaryKey];
+    (0, Helpers_1.checkPrimaryKeyValueType)(model, value);
+    // Adding the main query
+    query.where(model.instance.primaryKey, value);
     yield (0, Helpers_1.callHooks)(model, Enums_1.HookFunctionTypes.onBeforeShow, Object.assign(Object.assign({}, pack), { query,
         conditions }));
     // Users should be able to filter records

package/build/src/Handlers/UpdateHandler.js

@@ -24,9 +24,11 @@ exports.default = (pack) => __awaiter(void 0, void 0, void 0, function* () {
     // If there is a deletedAtColumn, it means that this table support soft-delete
     (0, Helpers_1.addSoftDeleteQuery)(model, null, query);
     yield (0, Helpers_1.callHooks)(model, Enums_1.HookFunctionTypes.onBeforeUpdateQuery, Object.assign(Object.assign({}, pack), { query }));
-    let item = yield query
-        .where(model.instance.primaryKey, req.params[model.instance.primaryKey])
-        .first();
+    // We should check the parameter type
+    const value = req.params[model.instance.primaryKey];
+    (0, Helpers_1.checkPrimaryKeyValueType)(model, value);
+    // Adding the main query
+    let item = yield query.where(model.instance.primaryKey, value).first();
     if (!item) {
         throw new ApiError_1.default(`The item is not found on ${model.name}.`);
     }

package/build/src/Interfaces.d.ts

@@ -145,13 +145,19 @@ export interface IRequestPack {
     database: Knex | Knex.Transaction;
 }
 export interface IRouteDocumentation {
+    version: string;
+    handler: string;
     model: string;
     table: string;
     columns: IColumn[];
+    hiddens: string[];
+    relations: IRelation[];
     method: HttpMethods;
     url: string;
     fillables: string[];
     validations: Record<string, string> | null;
+    queryLimits: IQueryLimitConfig[];
+    queryDefaults: IQueryDefaultConfig;
 }
 export interface IRawQuery {
     q: string | null;

package/build/src/Server.js

@@ -44,7 +44,8 @@ const knex_schema_inspector_1 = __importDefault(require("knex-schema-inspector")
 const knex_paginate_1 = require("knex-paginate");
 const Builders_1 = require("./Builders");
 const Services_1 = require("./Services");
-const DocsHandler_1 = __importDefault(require("./Handlers/DocsHandler"));
+const MetadataHandler_1 = __importDefault(require("./Handlers/MetadataHandler"));
+const DocsHTMLHandler_1 = __importDefault(require("./Handlers/DocsHTMLHandler"));
 const RoutesHandler_1 = __importDefault(require("./Handlers/RoutesHandler"));
 const Helpers_1 = require("./Helpers");
 class Server {
@@ -118,7 +119,8 @@ class Server {
             const logger = Services_1.LogService.getInstance();
             const api = Services_1.APIService.getInstance();
             if (api.config.env === "development") {
-                app.get("/docs", DocsHandler_1.default);
+                app.get("/metadata", MetadataHandler_1.default);
+                app.get("/docs", DocsHTMLHandler_1.default);
                 app.get("/routes", RoutesHandler_1.default);
             }
             app.listen(api.config.port, () => {

package/build/src/Services/DocumentationService.d.ts

@@ -1,11 +1,11 @@
-import { IModelService, IRouteDocumentation } from "../Interfaces";
-import { HttpMethods } from "../Enums";
+import { IModelService, IRouteDocumentation, IVersion } from "../Interfaces";
+import { HandlerTypes, HttpMethods } from "../Enums";
 declare class DocumentationService {
     private static instance;
     private routes;
     constructor();
     static getInstance(): DocumentationService;
-    push(method: HttpMethods, url: string, model: IModelService): void;
+    push(version: IVersion, handler: HandlerTypes, method: HttpMethods, url: string, model: IModelService): void;
     get(): IRouteDocumentation[];
 }
 export default DocumentationService;

package/build/src/Services/DocumentationService.js

@@ -10,15 +10,22 @@ class DocumentationService {
         }
         return DocumentationService.instance;
     }
-    push(method, url, model) {
+    push(version, handler, method, url, model) {
+        var _a, _b;
         this.routes.push({
+            version: version.name,
+            handler,
             model: model.name,
             table: model.instance.table,
             columns: model.columns,
+            hiddens: model.instance.hiddens,
+            relations: model.relations,
             method,
             url,
             fillables: model.instance.getFillableFields(method),
             validations: model.instance.getValidationRules(method),
+            queryLimits: model.queryLimits,
+            queryDefaults: ((_b = (_a = version.config) === null || _a === void 0 ? void 0 : _a.query) === null || _b === void 0 ? void 0 : _b.defaults) || {},
         });
     }
     get() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "axe-api",
-  "version": "0.30.2",
+  "version": "0.31.0",
   "description": "AXE API is a simple tool which has been created based on Express and Knex.js to create Rest APIs quickly.",
   "main": "build/index.js",
   "types": "build/index.d.ts",