arkos 1.4.0-canary.8 → 1.4.0-canary.82

package/dist/esm/modules/swagger/utils/helpers/get-file-upload-json-schema-paths.js

@@ -0,0 +1,413 @@
+import { getModuleComponents } from "../../../../utils/dynamic-loader.js";
+import { isEndpointDisabled } from "../../../base/utils/helpers/base.router.helpers.js";
+import deepmerge from "../../../../utils/helpers/deepmerge.helper.js";
+import { fileUploadDefaultRestrictions } from "../../../file-upload/file-upload.service.js";
+export default function getFileUploadJsonSchemaPaths(arkosConfig) {
+    const paths = {};
+    if (!arkosConfig.fileUpload)
+        return paths;
+    const FileUploadModuleComponents = getModuleComponents("file-upload");
+    const routerConfig = FileUploadModuleComponents?.router
+        ?.config;
+    const authConfigs = FileUploadModuleComponents?.authConfigs;
+    if (routerConfig?.disable === true)
+        return paths;
+    const isFileUploadEndpointDisabled = (endpoint) => {
+        return isEndpointDisabled(routerConfig, endpoint);
+    };
+    const basePathname = arkosConfig.fileUpload?.baseRoute || "/api/uploads/";
+    const baseUploadDir = arkosConfig.fileUpload?.baseUploadDir || "uploads";
+    const restrictions = deepmerge(fileUploadDefaultRestrictions, arkosConfig.fileUpload?.restrictions || {});
+    const formatBytes = (bytes) => {
+        if (bytes === 0)
+            return "0 Bytes";
+        const k = 1024;
+        const sizes = ["Bytes", "KB", "MB", "GB"];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return Math.round((bytes / Math.pow(k, i)) * 100) / 100 + " " + sizes[i];
+    };
+    const getFileTypeDescription = (fileType) => {
+        const restriction = restrictions[fileType];
+        if (!restriction)
+            return "";
+        const maxSize = formatBytes(restriction.maxSize);
+        const maxCount = restriction.maxCount;
+        const formats = restriction.supportedFilesRegex
+            ?.toString()
+            .replace(/\|/g, ", ")
+            .replace(/\//g, "")
+            .replace(/\.\*/g, "any format");
+        return `Maximum file size: ${maxSize}. Maximum files per upload: ${maxCount}. Supported formats: ${formats}`;
+    };
+    const shouldIncludeSecurity = (action) => {
+        const authControl = authConfigs?.authenticationControl;
+        if (!authControl)
+            return false;
+        if (typeof authControl === "boolean")
+            return authControl;
+        if (typeof authControl === "object") {
+            return authControl[action] === true;
+        }
+        return false;
+    };
+    if (!isFileUploadEndpointDisabled("findFile")) {
+        const cleanBasePath = basePathname.endsWith("/")
+            ? basePathname.slice(0, -1)
+            : basePathname;
+        paths[`${cleanBasePath}/{filePath*}`] = {
+            get: {
+                tags: ["File Upload"],
+                summary: "Retrieve uploaded file",
+                description: `Serves static files from the upload directory (${baseUploadDir}). This endpoint uses wildcard path matching to serve files from any subdirectory.`,
+                operationId: "findFile",
+                ...(shouldIncludeSecurity("View") && {
+                    security: [{ BearerAuth: [] }],
+                }),
+                parameters: [
+                    {
+                        name: "filePath",
+                        in: "path",
+                        required: true,
+                        schema: { type: "string" },
+                        description: "Path to the file including file type directory (e.g., images/photo.jpg, videos/clip.mp4)",
+                    },
+                ],
+                responses: {
+                    "200": {
+                        description: "File retrieved successfully",
+                        content: {
+                            "application/octet-stream": {
+                                schema: {
+                                    type: "string",
+                                    format: "binary",
+                                },
+                            },
+                        },
+                    },
+                    "404": {
+                        description: "File not found",
+                    },
+                    ...(shouldIncludeSecurity("View") && {
+                        "401": { description: "Authentication required" },
+                        "403": { description: "Insufficient permissions to view files" },
+                    }),
+                },
+            },
+        };
+    }
+    if (!isFileUploadEndpointDisabled("uploadFile")) {
+        const cleanBasePath = basePathname.endsWith("/")
+            ? basePathname.slice(0, -1)
+            : basePathname;
+        paths[`${cleanBasePath}/{fileType}`] = {
+            post: {
+                tags: ["File Upload"],
+                summary: "Upload file(s)",
+                description: "Upload one or multiple files. Supports image processing options for image uploads.",
+                operationId: "uploadFile",
+                ...(shouldIncludeSecurity("Create") && {
+                    security: [{ BearerAuth: [] }],
+                }),
+                parameters: [
+                    {
+                        name: "fileType",
+                        in: "path",
+                        required: true,
+                        schema: {
+                            type: "string",
+                            enum: ["images", "videos", "documents", "files"],
+                        },
+                        description: "Type of file being uploaded",
+                    },
+                    {
+                        name: "format",
+                        in: "query",
+                        required: false,
+                        schema: {
+                            type: "string",
+                            enum: ["jpeg", "jpg", "png", "webp", "gif", "avif"],
+                        },
+                        description: "Image format for conversion (only applicable for fileType=images)",
+                    },
+                    {
+                        name: "width",
+                        in: "query",
+                        required: false,
+                        schema: { type: "integer", minimum: 1 },
+                        description: "Target width for image resize (only applicable for fileType=images)",
+                    },
+                    {
+                        name: "height",
+                        in: "query",
+                        required: false,
+                        schema: { type: "integer", minimum: 1 },
+                        description: "Target height for image resize (only applicable for fileType=images)",
+                    },
+                    {
+                        name: "resizeTo",
+                        in: "query",
+                        required: false,
+                        schema: {
+                            type: "string",
+                            enum: ["cover", "contain", "fill", "inside", "outside"],
+                        },
+                        description: "Resize strategy (only applicable for fileType=images)",
+                    },
+                ],
+                requestBody: {
+                    required: true,
+                    content: {
+                        "multipart/form-data": {
+                            schema: {
+                                type: "object",
+                                properties: {
+                                    images: {
+                                        type: "array",
+                                        items: { type: "string", format: "binary" },
+                                        description: getFileTypeDescription("images"),
+                                    },
+                                    videos: {
+                                        type: "array",
+                                        items: { type: "string", format: "binary" },
+                                        description: getFileTypeDescription("videos"),
+                                    },
+                                    documents: {
+                                        type: "array",
+                                        items: { type: "string", format: "binary" },
+                                        description: getFileTypeDescription("documents"),
+                                    },
+                                    files: {
+                                        type: "array",
+                                        items: { type: "string", format: "binary" },
+                                        description: getFileTypeDescription("files"),
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+                responses: {
+                    "200": {
+                        description: "File(s) uploaded successfully",
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: "object",
+                                    properties: {
+                                        success: { type: "boolean", example: true },
+                                        data: {
+                                            oneOf: [
+                                                { type: "string", description: "URL of uploaded file" },
+                                                {
+                                                    type: "array",
+                                                    items: { type: "string" },
+                                                    description: "URLs of uploaded files",
+                                                },
+                                            ],
+                                        },
+                                        message: { type: "string" },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                    "400": {
+                        description: "Invalid file type, size limit exceeded, or no file uploaded",
+                    },
+                    ...(shouldIncludeSecurity("Create") && {
+                        "401": { description: "Authentication required" },
+                        "403": { description: "Insufficient permissions to upload files" },
+                    }),
+                },
+            },
+        };
+    }
+    if (!isFileUploadEndpointDisabled("updateFile")) {
+        const cleanBasePath = basePathname.endsWith("/")
+            ? basePathname.slice(0, -1)
+            : basePathname;
+        paths[`${cleanBasePath}/{fileType}/{fileName}`] = {
+            ...(paths[`${cleanBasePath}/{fileType}/{fileName}`] || {}),
+            patch: {
+                tags: ["File Upload"],
+                summary: "Update existing file",
+                description: "Replace an existing file with a new one. Deletes the old file and uploads the new one.",
+                operationId: "updateFile",
+                ...(shouldIncludeSecurity("Update") && {
+                    security: [{ BearerAuth: [] }],
+                }),
+                parameters: [
+                    {
+                        name: "fileType",
+                        in: "path",
+                        required: true,
+                        schema: {
+                            type: "string",
+                            enum: ["images", "videos", "documents", "files"],
+                        },
+                        description: "Type of file being updated",
+                    },
+                    {
+                        name: "fileName",
+                        in: "path",
+                        required: true,
+                        schema: { type: "string" },
+                        description: "Name of the file to update",
+                    },
+                    {
+                        name: "format",
+                        in: "query",
+                        required: false,
+                        schema: {
+                            type: "string",
+                            enum: ["jpeg", "jpg", "png", "webp", "gif", "avif"],
+                        },
+                        description: "Image format for conversion (only applicable for fileType=images)",
+                    },
+                    {
+                        name: "width",
+                        in: "query",
+                        required: false,
+                        schema: { type: "integer", minimum: 1 },
+                        description: "Target width for image resize (only applicable for fileType=images)",
+                    },
+                    {
+                        name: "height",
+                        in: "query",
+                        required: false,
+                        schema: { type: "integer", minimum: 1 },
+                        description: "Target height for image resize (only applicable for fileType=images)",
+                    },
+                    {
+                        name: "resizeTo",
+                        in: "query",
+                        required: false,
+                        schema: {
+                            type: "string",
+                            enum: ["cover", "contain", "fill", "inside", "outside"],
+                        },
+                        description: "Resize strategy (only applicable for fileType=images)",
+                    },
+                ],
+                requestBody: {
+                    required: true,
+                    content: {
+                        "multipart/form-data": {
+                            schema: {
+                                type: "object",
+                                properties: {
+                                    images: {
+                                        type: "array",
+                                        items: { type: "string", format: "binary" },
+                                        description: getFileTypeDescription("images"),
+                                    },
+                                    videos: {
+                                        type: "array",
+                                        items: { type: "string", format: "binary" },
+                                        description: getFileTypeDescription("videos"),
+                                    },
+                                    documents: {
+                                        type: "array",
+                                        items: { type: "string", format: "binary" },
+                                        description: getFileTypeDescription("documents"),
+                                    },
+                                    files: {
+                                        type: "array",
+                                        items: { type: "string", format: "binary" },
+                                        description: getFileTypeDescription("files"),
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+                responses: {
+                    "200": {
+                        description: "File updated successfully",
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: "object",
+                                    properties: {
+                                        success: { type: "boolean", example: true },
+                                        data: {
+                                            oneOf: [
+                                                { type: "string", description: "URL of updated file" },
+                                                {
+                                                    type: "array",
+                                                    items: { type: "string" },
+                                                    description: "URLs of updated files",
+                                                },
+                                            ],
+                                        },
+                                        message: { type: "string" },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                    "400": {
+                        description: "Invalid file type, size limit exceeded, or no file uploaded",
+                    },
+                    "404": {
+                        description: "Original file not found",
+                    },
+                    ...(shouldIncludeSecurity("Update") && {
+                        "401": { description: "Authentication required" },
+                        "403": { description: "Insufficient permissions to update files" },
+                    }),
+                },
+            },
+        };
+    }
+    if (!isFileUploadEndpointDisabled("deleteFile")) {
+        const cleanBasePath = basePathname.endsWith("/")
+            ? basePathname.slice(0, -1)
+            : basePathname;
+        if (!paths[`${cleanBasePath}/{fileType}/{fileName}`]) {
+            paths[`${cleanBasePath}/{fileType}/{fileName}`] = {};
+        }
+        paths[`${cleanBasePath}/{fileType}/{fileName}`].delete = {
+            tags: ["File Upload"],
+            summary: "Delete file",
+            description: "Delete an uploaded file from the server",
+            operationId: "deleteFile",
+            ...(shouldIncludeSecurity("Delete") && {
+                security: [{ BearerAuth: [] }],
+            }),
+            parameters: [
+                {
+                    name: "fileType",
+                    in: "path",
+                    required: true,
+                    schema: {
+                        type: "string",
+                        enum: ["images", "videos", "documents", "files"],
+                    },
+                    description: "Type of file being deleted",
+                },
+                {
+                    name: "fileName",
+                    in: "path",
+                    required: true,
+                    schema: { type: "string" },
+                    description: "Name of the file to delete",
+                },
+            ],
+            responses: {
+                "204": {
+                    description: "File deleted successfully",
+                },
+                "404": {
+                    description: "File not found",
+                },
+                ...(shouldIncludeSecurity("Delete") && {
+                    "401": { description: "Authentication required" },
+                    "403": { description: "Insufficient permissions to delete files" },
+                }),
+            },
+        };
+    }
+    return paths;
+}
+//# sourceMappingURL=get-file-upload-json-schema-paths.js.map

package/dist/esm/modules/swagger/utils/helpers/get-file-upload-json-schema-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-file-upload-json-schema-paths.js","sourceRoot":"","sources":["../../../../../../src/modules/swagger/utils/helpers/get-file-upload-json-schema-paths.ts"],"names":[],"mappings":"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","sourcesContent":["import { OpenAPIV3 } from \"openapi-types\";\nimport { ArkosConfig, RouterConfig } from \"../../../../exports\";\nimport { getModuleComponents } from \"../../../../utils/dynamic-loader\";\nimport { isEndpointDisabled } from \"../../../base/utils/helpers/base.router.helpers\";\nimport deepmerge from \"../../../../utils/helpers/deepmerge.helper\";\nimport { fileUploadDefaultRestrictions } from \"../../../file-upload/file-upload.service\";\n\nexport default function getFileUploadJsonSchemaPaths(arkosConfig: ArkosConfig) {\n  const paths: OpenAPIV3.PathsObject = {};\n\n  if (!arkosConfig.fileUpload) return paths;\n\n  const FileUploadModuleComponents = getModuleComponents(\"file-upload\");\n  const routerConfig = FileUploadModuleComponents?.router\n    ?.config as RouterConfig<\"file-upload\">;\n  const authConfigs = FileUploadModuleComponents?.authConfigs;\n\n  if (routerConfig?.disable === true) return paths;\n\n  const isFileUploadEndpointDisabled = (endpoint: string): boolean => {\n    return isEndpointDisabled(routerConfig, endpoint as any);\n  };\n\n  const basePathname = arkosConfig.fileUpload?.baseRoute || \"/api/uploads/\";\n  const baseUploadDir = arkosConfig.fileUpload?.baseUploadDir || \"uploads\";\n\n  const restrictions = deepmerge(\n    fileUploadDefaultRestrictions,\n    arkosConfig.fileUpload?.restrictions || {}\n  );\n\n  const formatBytes = (bytes: number): string => {\n    if (bytes === 0) return \"0 Bytes\";\n    const k = 1024;\n    const sizes = [\"Bytes\", \"KB\", \"MB\", \"GB\"];\n    const i = Math.floor(Math.log(bytes) / Math.log(k));\n    return Math.round((bytes / Math.pow(k, i)) * 100) / 100 + \" \" + sizes[i];\n  };\n\n  const getFileTypeDescription = (fileType: string): string => {\n    const restriction = restrictions[fileType as keyof typeof restrictions];\n    if (!restriction) return \"\";\n\n    const maxSize = formatBytes(restriction.maxSize!);\n    const maxCount = restriction.maxCount;\n    const formats = restriction.supportedFilesRegex\n      ?.toString()\n      .replace(/\\|/g, \", \")\n      .replace(/\\//g, \"\")\n      .replace(/\\.\\*/g, \"any format\");\n\n    return `Maximum file size: ${maxSize}. Maximum files per upload: ${maxCount}. Supported formats: ${formats}`;\n  };\n\n  const shouldIncludeSecurity = (\n    action: \"View\" | \"Create\" | \"Update\" | \"Delete\"\n  ): boolean => {\n    const authControl = authConfigs?.authenticationControl;\n    if (!authControl) return false;\n\n    if (typeof authControl === \"boolean\") return authControl;\n    if (typeof authControl === \"object\") {\n      return authControl[action] === true;\n    }\n\n    return false;\n  };\n\n  if (!isFileUploadEndpointDisabled(\"findFile\")) {\n    const cleanBasePath = basePathname.endsWith(\"/\")\n      ? basePathname.slice(0, -1)\n      : basePathname;\n\n    paths[`${cleanBasePath}/{filePath*}`] = {\n      get: {\n        tags: [\"File Upload\"],\n        summary: \"Retrieve uploaded file\",\n        description: `Serves static files from the upload directory (${baseUploadDir}). This endpoint uses wildcard path matching to serve files from any subdirectory.`,\n        operationId: \"findFile\",\n        ...(shouldIncludeSecurity(\"View\") && {\n          security: [{ BearerAuth: [] }],\n        }),\n        parameters: [\n          {\n            name: \"filePath\",\n            in: \"path\",\n            required: true,\n            schema: { type: \"string\" },\n            description:\n              \"Path to the file including file type directory (e.g., images/photo.jpg, videos/clip.mp4)\",\n          },\n        ],\n        responses: {\n          \"200\": {\n            description: \"File retrieved successfully\",\n            content: {\n              \"application/octet-stream\": {\n                schema: {\n                  type: \"string\",\n                  format: \"binary\",\n                },\n              },\n            },\n          },\n          \"404\": {\n            description: \"File not found\",\n          },\n          ...(shouldIncludeSecurity(\"View\") && {\n            \"401\": { description: \"Authentication required\" },\n            \"403\": { description: \"Insufficient permissions to view files\" },\n          }),\n        },\n      },\n    };\n  }\n\n  if (!isFileUploadEndpointDisabled(\"uploadFile\")) {\n    const cleanBasePath = basePathname.endsWith(\"/\")\n      ? basePathname.slice(0, -1)\n      : basePathname;\n\n    paths[`${cleanBasePath}/{fileType}`] = {\n      post: {\n        tags: [\"File Upload\"],\n        summary: \"Upload file(s)\",\n        description:\n          \"Upload one or multiple files. Supports image processing options for image uploads.\",\n        operationId: \"uploadFile\",\n        ...(shouldIncludeSecurity(\"Create\") && {\n          security: [{ BearerAuth: [] }],\n        }),\n        parameters: [\n          {\n            name: \"fileType\",\n            in: \"path\",\n            required: true,\n            schema: {\n              type: \"string\",\n              enum: [\"images\", \"videos\", \"documents\", \"files\"],\n            },\n            description: \"Type of file being uploaded\",\n          },\n          {\n            name: \"format\",\n            in: \"query\",\n            required: false,\n            schema: {\n              type: \"string\",\n              enum: [\"jpeg\", \"jpg\", \"png\", \"webp\", \"gif\", \"avif\"],\n            },\n            description:\n              \"Image format for conversion (only applicable for fileType=images)\",\n          },\n          {\n            name: \"width\",\n            in: \"query\",\n            required: false,\n            schema: { type: \"integer\", minimum: 1 },\n            description:\n              \"Target width for image resize (only applicable for fileType=images)\",\n          },\n          {\n            name: \"height\",\n            in: \"query\",\n            required: false,\n            schema: { type: \"integer\", minimum: 1 },\n            description:\n              \"Target height for image resize (only applicable for fileType=images)\",\n          },\n          {\n            name: \"resizeTo\",\n            in: \"query\",\n            required: false,\n            schema: {\n              type: \"string\",\n              enum: [\"cover\", \"contain\", \"fill\", \"inside\", \"outside\"],\n            },\n            description:\n              \"Resize strategy (only applicable for fileType=images)\",\n          },\n        ],\n        requestBody: {\n          required: true,\n          content: {\n            \"multipart/form-data\": {\n              schema: {\n                type: \"object\",\n                properties: {\n                  images: {\n                    type: \"array\",\n                    items: { type: \"string\", format: \"binary\" },\n                    description: getFileTypeDescription(\"images\"),\n                  },\n                  videos: {\n                    type: \"array\",\n                    items: { type: \"string\", format: \"binary\" },\n                    description: getFileTypeDescription(\"videos\"),\n                  },\n                  documents: {\n                    type: \"array\",\n                    items: { type: \"string\", format: \"binary\" },\n                    description: getFileTypeDescription(\"documents\"),\n                  },\n                  files: {\n                    type: \"array\",\n                    items: { type: \"string\", format: \"binary\" },\n                    description: getFileTypeDescription(\"files\"),\n                  },\n                },\n              },\n            },\n          },\n        },\n        responses: {\n          \"200\": {\n            description: \"File(s) uploaded successfully\",\n            content: {\n              \"application/json\": {\n                schema: {\n                  type: \"object\",\n                  properties: {\n                    success: { type: \"boolean\", example: true },\n                    data: {\n                      oneOf: [\n                        { type: \"string\", description: \"URL of uploaded file\" },\n                        {\n                          type: \"array\",\n                          items: { type: \"string\" },\n                          description: \"URLs of uploaded files\",\n                        },\n                      ],\n                    },\n                    message: { type: \"string\" },\n                  },\n                },\n              },\n            },\n          },\n          \"400\": {\n            description:\n              \"Invalid file type, size limit exceeded, or no file uploaded\",\n          },\n          ...(shouldIncludeSecurity(\"Create\") && {\n            \"401\": { description: \"Authentication required\" },\n            \"403\": { description: \"Insufficient permissions to upload files\" },\n          }),\n        },\n      },\n    };\n  }\n\n  if (!isFileUploadEndpointDisabled(\"updateFile\")) {\n    const cleanBasePath = basePathname.endsWith(\"/\")\n      ? basePathname.slice(0, -1)\n      : basePathname;\n\n    paths[`${cleanBasePath}/{fileType}/{fileName}`] = {\n      ...(paths[`${cleanBasePath}/{fileType}/{fileName}`] || {}),\n      patch: {\n        tags: [\"File Upload\"],\n        summary: \"Update existing file\",\n        description:\n          \"Replace an existing file with a new one. Deletes the old file and uploads the new one.\",\n        operationId: \"updateFile\",\n        ...(shouldIncludeSecurity(\"Update\") && {\n          security: [{ BearerAuth: [] }],\n        }),\n        parameters: [\n          {\n            name: \"fileType\",\n            in: \"path\",\n            required: true,\n            schema: {\n              type: \"string\",\n              enum: [\"images\", \"videos\", \"documents\", \"files\"],\n            },\n            description: \"Type of file being updated\",\n          },\n          {\n            name: \"fileName\",\n            in: \"path\",\n            required: true,\n            schema: { type: \"string\" },\n            description: \"Name of the file to update\",\n          },\n          {\n            name: \"format\",\n            in: \"query\",\n            required: false,\n            schema: {\n              type: \"string\",\n              enum: [\"jpeg\", \"jpg\", \"png\", \"webp\", \"gif\", \"avif\"],\n            },\n            description:\n              \"Image format for conversion (only applicable for fileType=images)\",\n          },\n          {\n            name: \"width\",\n            in: \"query\",\n            required: false,\n            schema: { type: \"integer\", minimum: 1 },\n            description:\n              \"Target width for image resize (only applicable for fileType=images)\",\n          },\n          {\n            name: \"height\",\n            in: \"query\",\n            required: false,\n            schema: { type: \"integer\", minimum: 1 },\n            description:\n              \"Target height for image resize (only applicable for fileType=images)\",\n          },\n          {\n            name: \"resizeTo\",\n            in: \"query\",\n            required: false,\n            schema: {\n              type: \"string\",\n              enum: [\"cover\", \"contain\", \"fill\", \"inside\", \"outside\"],\n            },\n            description:\n              \"Resize strategy (only applicable for fileType=images)\",\n          },\n        ],\n        requestBody: {\n          required: true,\n          content: {\n            \"multipart/form-data\": {\n              schema: {\n                type: \"object\",\n                properties: {\n                  images: {\n                    type: \"array\",\n                    items: { type: \"string\", format: \"binary\" },\n                    description: getFileTypeDescription(\"images\"),\n                  },\n                  videos: {\n                    type: \"array\",\n                    items: { type: \"string\", format: \"binary\" },\n                    description: getFileTypeDescription(\"videos\"),\n                  },\n                  documents: {\n                    type: \"array\",\n                    items: { type: \"string\", format: \"binary\" },\n                    description: getFileTypeDescription(\"documents\"),\n                  },\n                  files: {\n                    type: \"array\",\n                    items: { type: \"string\", format: \"binary\" },\n                    description: getFileTypeDescription(\"files\"),\n                  },\n                },\n              },\n            },\n          },\n        },\n        responses: {\n          \"200\": {\n            description: \"File updated successfully\",\n            content: {\n              \"application/json\": {\n                schema: {\n                  type: \"object\",\n                  properties: {\n                    success: { type: \"boolean\", example: true },\n                    data: {\n                      oneOf: [\n                        { type: \"string\", description: \"URL of updated file\" },\n                        {\n                          type: \"array\",\n                          items: { type: \"string\" },\n                          description: \"URLs of updated files\",\n                        },\n                      ],\n                    },\n                    message: { type: \"string\" },\n                  },\n                },\n              },\n            },\n          },\n          \"400\": {\n            description:\n              \"Invalid file type, size limit exceeded, or no file uploaded\",\n          },\n          \"404\": {\n            description: \"Original file not found\",\n          },\n          ...(shouldIncludeSecurity(\"Update\") && {\n            \"401\": { description: \"Authentication required\" },\n            \"403\": { description: \"Insufficient permissions to update files\" },\n          }),\n        },\n      },\n    };\n  }\n\n  if (!isFileUploadEndpointDisabled(\"deleteFile\")) {\n    const cleanBasePath = basePathname.endsWith(\"/\")\n      ? basePathname.slice(0, -1)\n      : basePathname;\n\n    if (!paths[`${cleanBasePath}/{fileType}/{fileName}`]) {\n      paths[`${cleanBasePath}/{fileType}/{fileName}`] = {};\n    }\n\n    paths[`${cleanBasePath}/{fileType}/{fileName}`]!.delete = {\n      tags: [\"File Upload\"],\n      summary: \"Delete file\",\n      description: \"Delete an uploaded file from the server\",\n      operationId: \"deleteFile\",\n      ...(shouldIncludeSecurity(\"Delete\") && {\n        security: [{ BearerAuth: [] }],\n      }),\n      parameters: [\n        {\n          name: \"fileType\",\n          in: \"path\",\n          required: true,\n          schema: {\n            type: \"string\",\n            enum: [\"images\", \"videos\", \"documents\", \"files\"],\n          },\n          description: \"Type of file being deleted\",\n        },\n        {\n          name: \"fileName\",\n          in: \"path\",\n          required: true,\n          schema: { type: \"string\" },\n          description: \"Name of the file to delete\",\n        },\n      ],\n      responses: {\n        \"204\": {\n          description: \"File deleted successfully\",\n        },\n        \"404\": {\n          description: \"File not found\",\n        },\n        ...(shouldIncludeSecurity(\"Delete\") && {\n          \"401\": { description: \"Authentication required\" },\n          \"403\": { description: \"Insufficient permissions to delete files\" },\n        }),\n      },\n    };\n  }\n\n  return paths;\n}\n"]}

package/dist/esm/modules/swagger/utils/helpers/get-swagger-default-configs.js

@@ -1,7 +1,7 @@
 import { capitalize } from "../../../../utils/helpers/text.helpers.js";
 import portAndHostAllocator from "../../../../utils/features/port-and-host-allocator.js";
-export default async function getSwaggerDefaultConfig(defaultModelsPaths, defaultJsonSchemas) {
-    const portAndHost = await portAndHostAllocator.getHostAndAvailablePort({});
+export default function getSwaggerDefaultConfig(defaultModelsPaths, defaultJsonSchemas) {
+    const portAndHost = portAndHostAllocator;
     return {
         endpoint: "/docs",
         mode: "prisma",
@@ -16,7 +16,7 @@ export default async function getSwaggerDefaultConfig(defaultModelsPaths, defaul
                 },
                 servers: [
                     {
-                        url: `http://${portAndHost.host}:${portAndHost.port}`,
+                        url: `http://${["0.0.0.0", "localhost", "127.0.0.1"].includes(portAndHost.host) ? "localhost" : portAndHost.host}:${portAndHost.port}`,
                         description: `Local ${capitalize(process.env.NODE_ENV || "development")} Server`,
                     },
                 ],

package/dist/esm/modules/swagger/utils/helpers/get-swagger-default-configs.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-swagger-default-configs.js","sourceRoot":"","sources":["../../../../../../src/modules/swagger/utils/helpers/get-swagger-default-configs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,oBAAoB,MAAM,oDAAoD,CAAC;AAEtF,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,uBAAuB,CACnD,kBAAuC,EACvC,kBAAiD;IAEjD,MAAM,WAAW,GAAG,MAAM,oBAAoB,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC;IAE3E,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACP,UAAU,EAAE;gBACV,OAAO,EAAE,OAAO;gBAChB,IAAI,EAAE;oBACJ,KAAK,EAAE,qBAAqB;oBAC5B,OAAO,EAAE,OAAO;oBAChB,WAAW,EACT,sFAAsF;iBACzF;gBACD,OAAO,EAAE;oBACP;wBACE,GAAG,EAAE,UAAU,WAAW,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,EAAE;wBACrD,WAAW,EAAE,SAAS,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa,CAAC,SAAS;qBACjF;iBACF;gBACD,KAAK,EAAE,kBAAkB;gBACzB,UAAU,EAAE;oBACV,OAAO,EAAE,kBAAkB,IAAI,EAAE;oBACjC,eAAe,EAAE;wBACf,UAAU,EAAE;4BACV,IAAI,EAAE,MAAM;4BACZ,MAAM,EAAE,QAAQ;4BAChB,YAAY,EAAE,KAAK;yBACpB;qBACF;iBACF;gBACD,QAAQ,EAAE,EAAE;aACb;YACD,IAAI,EAAE;gBACJ,gCAAgC;gBAChC,mCAAmC;aACpC;YACD,WAAW,EAAE,IAAI;YACjB,eAAe,EAAE,IAAI;YACrB,oBAAoB,EAAE,KAAK;SAC5B;QACD,+BAA+B,EAAE;YAC/B,KAAK,EAAE,WAAW;YAClB,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,IAAI;YACjB,kBAAkB,EAAE,KAAK;YACzB,QAAQ,EAAE;gBACR,KAAK,EAAE,4BAA4B;gBACnC,WAAW,EAAE,yCAAyC;aACvD;YACD,SAAS,EAAE,4BAA4B;SACxC;KACwB,CAAC;AAC9B,CAAC","sourcesContent":["import { OpenAPIV3 } from \"openapi-types\";\nimport { ArkosConfig } from \"../../../../exports\";\nimport { capitalize } from \"../../../../utils/helpers/text.helpers\";\nimport portAndHostAllocator from \"../../../../utils/features/port-and-host-allocator\";\n\nexport default async function getSwaggerDefaultConfig(\n  defaultModelsPaths: Record<string, any>,\n  defaultJsonSchemas: OpenAPIV3.PathsObject<{}, {}>\n) {\n  const portAndHost = await portAndHostAllocator.getHostAndAvailablePort({});\n\n  return {\n    endpoint: \"/docs\",\n    mode: \"prisma\",\n    strict: false,\n    options: {\n      definition: {\n        openapi: \"3.0.0\",\n        info: {\n          title: \"Powered By Arkos.js\",\n          version: \"1.0.0\",\n          description:\n            \"This API was automatically generated by Arkos.js, read more about at www.arkosjs.com\",\n        },\n        servers: [\n          {\n            url: `http://${portAndHost.host}:${portAndHost.port}`,\n            description: `Local ${capitalize(process.env.NODE_ENV || \"development\")} Server`,\n          },\n        ],\n        paths: defaultModelsPaths,\n        components: {\n          schemas: defaultJsonSchemas || {},\n          securitySchemes: {\n            BearerAuth: {\n              type: \"http\",\n              scheme: \"bearer\",\n              bearerFormat: \"JWT\",\n            },\n          },\n        },\n        security: [],\n      },\n      apis: [\n        \"./src/routers/*.router.{ts,js}\",\n        \"./src/modules/**/*.router.{ts,js}\",\n      ],\n      deepLinking: true,\n      tryItOutEnabled: true,\n      persistAuthorization: false,\n    },\n    scalarApiReferenceConfiguration: {\n      theme: \"deepSpace\",\n      darkMode: true,\n      layout: \"modern\",\n      showSidebar: true,\n      hideDownloadButton: false,\n      metaData: {\n        title: \"Arkos.js API Documentation\",\n        description: \"API documentation generated by Arkos.js\",\n      },\n      pageTitle: \"Arkos.js API Documentation\",\n    },\n  } as ArkosConfig[\"swagger\"];\n}\n"]}
+{"version":3,"file":"get-swagger-default-configs.js","sourceRoot":"","sources":["../../../../../../src/modules/swagger/utils/helpers/get-swagger-default-configs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,oBAAoB,MAAM,oDAAoD,CAAC;AAEtF,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC7C,kBAAuC,EACvC,kBAAiD;IAEjD,MAAM,WAAW,GAAG,oBAAoB,CAAC;IAEzC,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACP,UAAU,EAAE;gBACV,OAAO,EAAE,OAAO;gBAChB,IAAI,EAAE;oBACJ,KAAK,EAAE,qBAAqB;oBAC5B,OAAO,EAAE,OAAO;oBAChB,WAAW,EACT,sFAAsF;iBACzF;gBACD,OAAO,EAAE;oBACP;wBACE,GAAG,EAAE,UAAU,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,EAAE;wBACvI,WAAW,EAAE,SAAS,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa,CAAC,SAAS;qBACjF;iBACF;gBACD,KAAK,EAAE,kBAAkB;gBACzB,UAAU,EAAE;oBACV,OAAO,EAAE,kBAAkB,IAAI,EAAE;oBACjC,eAAe,EAAE;wBACf,UAAU,EAAE;4BACV,IAAI,EAAE,MAAM;4BACZ,MAAM,EAAE,QAAQ;4BAChB,YAAY,EAAE,KAAK;yBACpB;qBACF;iBACF;gBACD,QAAQ,EAAE,EAAE;aACb;YACD,IAAI,EAAE;gBACJ,gCAAgC;gBAChC,mCAAmC;aACpC;YACD,WAAW,EAAE,IAAI;YACjB,eAAe,EAAE,IAAI;YACrB,oBAAoB,EAAE,KAAK;SAC5B;QACD,+BAA+B,EAAE;YAC/B,KAAK,EAAE,WAAW;YAClB,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,IAAI;YACjB,kBAAkB,EAAE,KAAK;YACzB,QAAQ,EAAE;gBACR,KAAK,EAAE,4BAA4B;gBACnC,WAAW,EAAE,yCAAyC;aACvD;YACD,SAAS,EAAE,4BAA4B;SACxC;KACwB,CAAC;AAC9B,CAAC","sourcesContent":["import { OpenAPIV3 } from \"openapi-types\";\nimport { ArkosConfig } from \"../../../../exports\";\nimport { capitalize } from \"../../../../utils/helpers/text.helpers\";\nimport portAndHostAllocator from \"../../../../utils/features/port-and-host-allocator\";\n\nexport default function getSwaggerDefaultConfig(\n  defaultModelsPaths: Record<string, any>,\n  defaultJsonSchemas: OpenAPIV3.PathsObject<{}, {}>\n) {\n  const portAndHost = portAndHostAllocator;\n\n  return {\n    endpoint: \"/docs\",\n    mode: \"prisma\",\n    strict: false,\n    options: {\n      definition: {\n        openapi: \"3.0.0\",\n        info: {\n          title: \"Powered By Arkos.js\",\n          version: \"1.0.0\",\n          description:\n            \"This API was automatically generated by Arkos.js, read more about at www.arkosjs.com\",\n        },\n        servers: [\n          {\n            url: `http://${[\"0.0.0.0\", \"localhost\", \"127.0.0.1\"].includes(portAndHost.host!) ? \"localhost\" : portAndHost.host}:${portAndHost.port}`,\n            description: `Local ${capitalize(process.env.NODE_ENV || \"development\")} Server`,\n          },\n        ],\n        paths: defaultModelsPaths,\n        components: {\n          schemas: defaultJsonSchemas || {},\n          securitySchemes: {\n            BearerAuth: {\n              type: \"http\",\n              scheme: \"bearer\",\n              bearerFormat: \"JWT\",\n            },\n          },\n        },\n        security: [],\n      },\n      apis: [\n        \"./src/routers/*.router.{ts,js}\",\n        \"./src/modules/**/*.router.{ts,js}\",\n      ],\n      deepLinking: true,\n      tryItOutEnabled: true,\n      persistAuthorization: false,\n    },\n    scalarApiReferenceConfiguration: {\n      theme: \"deepSpace\",\n      darkMode: true,\n      layout: \"modern\",\n      showSidebar: true,\n      hideDownloadButton: false,\n      metaData: {\n        title: \"Arkos.js API Documentation\",\n        description: \"API documentation generated by Arkos.js\",\n      },\n      pageTitle: \"Arkos.js API Documentation\",\n    },\n  } as ArkosConfig[\"swagger\"];\n}\n"]}

package/dist/esm/modules/swagger/utils/helpers/json-schema-generators/generate-class-validator-json-schemas.js

@@ -1,17 +1,16 @@
 import { validationMetadatasToSchemas } from "class-validator-jsonschema";
-import { importModule } from "../../../../../utils/helpers/global.helpers.js";
 import { getMetadataStorage } from "class-validator";
 import { getModuleComponents } from "../../../../../utils/dynamic-loader.js";
 import { getCorrectJsonSchemaName } from "../swagger.router.helpers.js";
 import prismaSchemaParser from "../../../../../utils/prisma/prisma-schema-parser.js";
 import { getUserFileExtension } from "../../../../../utils/helpers/fs.helpers.js";
-export async function generateClassValidatorJsonSchemas() {
+import { defaultMetadataStorage } from "class-transformer/cjs/storage";
+export function generateClassValidatorJsonSchemas() {
     const requiredAppModules = [
         ...prismaSchemaParser.getModelsAsArrayOfStrings(),
         "auth",
     ];
     const schemas = {};
-    const { defaultMetadataStorage } = await importModule("class-transformer/cjs/storage.js");
     const jsonSchema = validationMetadatasToSchemas({
         classValidatorMetadataStorage: getMetadataStorage(),
         classTransformerMetadataStorage: defaultMetadataStorage,
@@ -25,9 +24,8 @@ export async function generateClassValidatorJsonSchemas() {
                 if (dtoClass && !ignoredDtoTypes.includes(dtoType.toLowerCase())) {
                     try {
                         const schemaName = getCorrectJsonSchemaName(dtoType, modelName, "Dto");
-                        if (schemas[schemaName]) {
+                        if (schemas[schemaName])
                             throw Error(`Found more then 1 ${dtoClass.name} classes among your .dto.${getUserFileExtension()} files, there is no way to correctly generate json-schemas for swagger documentation.`);
-                        }
                         schemas[schemaName] = jsonSchema[dtoClass.name] || {};
                     }
                     catch (err) {

package/dist/esm/modules/swagger/utils/helpers/json-schema-generators/generate-class-validator-json-schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate-class-validator-json-schemas.js","sourceRoot":"","sources":["../../../../../../../src/modules/swagger/utils/helpers/json-schema-generators/generate-class-validator-json-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,kBAAkB,MAAM,kDAAkD,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E,MAAM,CAAC,KAAK,UAAU,iCAAiC;IACrD,MAAM,kBAAkB,GAAG;QACzB,GAAG,kBAAkB,CAAC,yBAAyB,EAAE;QACjD,MAAM;KACP,CAAC;IACF,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,YAAY,CACnD,kCAAkC,CACnC,CAAC;IAEF,MAAM,UAAU,GAAG,4BAA4B,CAAC;QAC9C,6BAA6B,EAAE,kBAAkB,EAAE;QACnD,+BAA+B,EAAE,sBAAsB;QACvD,gBAAgB,EAAE,uBAAuB;KAC1C,CAAC,CAAC;IAEH,kBAAkB,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QACvC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAExD,IAAI,gBAAgB,EAAE,IAAI,EAAE,CAAC;YAC3B,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE;gBACpE,MAAM,eAAe,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;gBACnD,IAAI,QAAQ,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBACjE,IAAI,CAAC;wBACH,MAAM,UAAU,GAAG,wBAAwB,CACzC,OAAO,EACP,SAAS,EACT,KAAK,CACN,CAAC;wBAEF,IAAI,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;4BACxB,MAAM,KAAK,CACT,qBAAqB,QAAQ,CAAC,IAAI,4BAA4B,oBAAoB,EAAE,uFAAuF,CAC5K,CAAC;wBACJ,CAAC;wBAED,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACxD,CAAC;oBAAC,OAAO,GAAQ,EAAE,CAAC;wBAClB,MAAM,IAAI,KAAK,CACb,iCAAiC,OAAO,IAAI,SAAS,KAAK,GAAG,CAAC,OAAO,EAAE,CACxE,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE;QACzD,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;YAAE,OAAO,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC;IACvD,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { validationMetadatasToSchemas } from \"class-validator-jsonschema\";\nimport { importModule } from \"../../../../../utils/helpers/global.helpers\";\nimport { getMetadataStorage } from \"class-validator\";\nimport { getModuleComponents } from \"../../../../../utils/dynamic-loader\";\nimport { getCorrectJsonSchemaName } from \"../swagger.router.helpers\";\nimport prismaSchemaParser from \"../../../../../utils/prisma/prisma-schema-parser\";\nimport { getUserFileExtension } from \"../../../../../utils/helpers/fs.helpers\";\n\nexport async function generateClassValidatorJsonSchemas() {\n  const requiredAppModules = [\n    ...prismaSchemaParser.getModelsAsArrayOfStrings(),\n    \"auth\",\n  ];\n  const schemas: Record<string, any> = {};\n\n  const { defaultMetadataStorage } = await importModule(\n    \"class-transformer/cjs/storage.js\"\n  );\n\n  const jsonSchema = validationMetadatasToSchemas({\n    classValidatorMetadataStorage: getMetadataStorage(),\n    classTransformerMetadataStorage: defaultMetadataStorage,\n    refPointerPrefix: \"#/components/schemas/\",\n  });\n\n  requiredAppModules.forEach((modelName) => {\n    const moduleComponents = getModuleComponents(modelName);\n\n    if (moduleComponents?.dtos) {\n      Object.entries(moduleComponents.dtos).forEach(([dtoType, dtoClass]) => {\n        const ignoredDtoTypes = [\"createone\", \"updateone\"];\n        if (dtoClass && !ignoredDtoTypes.includes(dtoType.toLowerCase())) {\n          try {\n            const schemaName = getCorrectJsonSchemaName(\n              dtoType,\n              modelName,\n              \"Dto\"\n            );\n\n            if (schemas[schemaName]) {\n              throw Error(\n                `Found more then 1 ${dtoClass.name} classes among your .dto.${getUserFileExtension()} files, there is no way to correctly generate json-schemas for swagger documentation.`\n              );\n            }\n\n            schemas[schemaName] = jsonSchema[dtoClass.name] || {};\n          } catch (err: any) {\n            throw new Error(\n              `Failed to generate schema for ${dtoType} ${modelName}: ${err.message}`\n            );\n          }\n        }\n      });\n    }\n  });\n\n  Object.entries(jsonSchema).forEach(([className, schema]) => {\n    if (!schemas[className]) schemas[className] = schema;\n  });\n  return schemas;\n}\n"]}
+{"version":3,"file":"generate-class-validator-json-schemas.js","sourceRoot":"","sources":["../../../../../../../src/modules/swagger/utils/helpers/json-schema-generators/generate-class-validator-json-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,kBAAkB,MAAM,kDAAkD,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,MAAM,UAAU,iCAAiC;IAC/C,MAAM,kBAAkB,GAAG;QACzB,GAAG,kBAAkB,CAAC,yBAAyB,EAAE;QACjD,MAAM;KACP,CAAC;IACF,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,MAAM,UAAU,GAAG,4BAA4B,CAAC;QAC9C,6BAA6B,EAAE,kBAAkB,EAAE;QACnD,+BAA+B,EAAE,sBAAsB;QACvD,gBAAgB,EAAE,uBAAuB;KAC1C,CAAC,CAAC;IAEH,kBAAkB,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QACvC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAExD,IAAI,gBAAgB,EAAE,IAAI,EAAE,CAAC;YAC3B,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE;gBACpE,MAAM,eAAe,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;gBACnD,IAAI,QAAQ,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBACjE,IAAI,CAAC;wBACH,MAAM,UAAU,GAAG,wBAAwB,CACzC,OAAO,EACP,SAAS,EACT,KAAK,CACN,CAAC;wBAEF,IAAI,OAAO,CAAC,UAAU,CAAC;4BACrB,MAAM,KAAK,CACT,qBAAqB,QAAQ,CAAC,IAAI,4BAA4B,oBAAoB,EAAE,uFAAuF,CAC5K,CAAC;wBAEJ,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACxD,CAAC;oBAAC,OAAO,GAAQ,EAAE,CAAC;wBAClB,MAAM,IAAI,KAAK,CACb,iCAAiC,OAAO,IAAI,SAAS,KAAK,GAAG,CAAC,OAAO,EAAE,CACxE,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE;QACzD,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;YAAE,OAAO,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC;IACvD,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { validationMetadatasToSchemas } from \"class-validator-jsonschema\";\nimport { getMetadataStorage } from \"class-validator\";\nimport { getModuleComponents } from \"../../../../../utils/dynamic-loader\";\nimport { getCorrectJsonSchemaName } from \"../swagger.router.helpers\";\nimport prismaSchemaParser from \"../../../../../utils/prisma/prisma-schema-parser\";\nimport { getUserFileExtension } from \"../../../../../utils/helpers/fs.helpers\";\nimport { defaultMetadataStorage } from \"class-transformer/cjs/storage\";\n\nexport function generateClassValidatorJsonSchemas() {\n  const requiredAppModules = [\n    ...prismaSchemaParser.getModelsAsArrayOfStrings(),\n    \"auth\",\n  ];\n  const schemas: Record<string, any> = {};\n\n  const jsonSchema = validationMetadatasToSchemas({\n    classValidatorMetadataStorage: getMetadataStorage(),\n    classTransformerMetadataStorage: defaultMetadataStorage,\n    refPointerPrefix: \"#/components/schemas/\",\n  });\n\n  requiredAppModules.forEach((modelName) => {\n    const moduleComponents = getModuleComponents(modelName);\n\n    if (moduleComponents?.dtos) {\n      Object.entries(moduleComponents.dtos).forEach(([dtoType, dtoClass]) => {\n        const ignoredDtoTypes = [\"createone\", \"updateone\"];\n        if (dtoClass && !ignoredDtoTypes.includes(dtoType.toLowerCase())) {\n          try {\n            const schemaName = getCorrectJsonSchemaName(\n              dtoType,\n              modelName,\n              \"Dto\"\n            );\n\n            if (schemas[schemaName])\n              throw Error(\n                `Found more then 1 ${dtoClass.name} classes among your .dto.${getUserFileExtension()} files, there is no way to correctly generate json-schemas for swagger documentation.`\n              );\n\n            schemas[schemaName] = jsonSchema[dtoClass.name] || {};\n          } catch (err: any) {\n            throw new Error(\n              `Failed to generate schema for ${dtoType} ${modelName}: ${err.message}`\n            );\n          }\n        }\n      });\n    }\n  });\n\n  Object.entries(jsonSchema).forEach(([className, schema]) => {\n    if (!schemas[className]) schemas[className] = schema;\n  });\n  return schemas;\n}\n"]}

package/dist/esm/modules/swagger/utils/helpers/json-schema-generators/generate-prisma-json-schemas.js

@@ -1,18 +1,18 @@
 import prismaJsonSchemaGenerator from "../../../../../utils/prisma/prisma-json-schema-generator.js";
 import prismaSchemaParser from "../../../../../utils/prisma/prisma-schema-parser.js";
-export async function generatePrismaJsonSchemas(arkosConfig) {
+export function generatePrismaJsonSchemas(arkosConfig) {
     const requiredAppModules = [
         ...prismaSchemaParser.getModelsAsArrayOfStrings(),
         "auth",
     ];
     try {
-        const modelSchemasArray = await Promise.all(requiredAppModules.map(async (modelName) => {
-            const modelSchemas = await prismaJsonSchemaGenerator.generateModelSchemas({
+        const modelSchemasArray = requiredAppModules.map((modelName) => {
+            const modelSchemas = prismaJsonSchemaGenerator.generateModelSchemas({
                 modelName,
                 arkosConfig,
             });
             return modelSchemas;
-        }));
+        });
         const schemas = modelSchemasArray.reduce((acc, modelSchemas) => {
             return { ...acc, ...modelSchemas };
         }, {});

package/dist/esm/modules/swagger/utils/helpers/json-schema-generators/generate-prisma-json-schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate-prisma-json-schemas.js","sourceRoot":"","sources":["../../../../../../../src/modules/swagger/utils/helpers/json-schema-generators/generate-prisma-json-schemas.ts"],"names":[],"mappings":"AACA,OAAO,yBAAyB,MAAM,0DAA0D,CAAC;AACjG,OAAO,kBAAkB,MAAM,kDAAkD,CAAC;AAElF,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,WAAwB;IACtE,MAAM,kBAAkB,GAAG;QACzB,GAAG,kBAAkB,CAAC,yBAAyB,EAAE;QACjD,MAAM;KACP,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC,GAAG,CACzC,kBAAkB,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;YACzC,MAAM,YAAY,GAChB,MAAM,yBAAyB,CAAC,oBAAoB,CAAC;gBACnD,SAAS;gBACT,WAAW;aACZ,CAAC,CAAC;YACL,OAAO,YAAY,CAAC;QACtB,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE;YAC7D,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;QACrC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC","sourcesContent":["import { ArkosConfig } from \"../../../../../exports\";\nimport prismaJsonSchemaGenerator from \"../../../../../utils/prisma/prisma-json-schema-generator\";\nimport prismaSchemaParser from \"../../../../../utils/prisma/prisma-schema-parser\";\n\nexport async function generatePrismaJsonSchemas(arkosConfig: ArkosConfig) {\n  const requiredAppModules = [\n    ...prismaSchemaParser.getModelsAsArrayOfStrings(),\n    \"auth\",\n  ];\n\n  try {\n    const modelSchemasArray = await Promise.all(\n      requiredAppModules.map(async (modelName) => {\n        const modelSchemas =\n          await prismaJsonSchemaGenerator.generateModelSchemas({\n            modelName,\n            arkosConfig,\n          });\n        return modelSchemas;\n      })\n    );\n\n    const schemas = modelSchemasArray.reduce((acc, modelSchemas) => {\n      return { ...acc, ...modelSchemas };\n    }, {});\n\n    return schemas;\n  } catch (err) {\n    console.error(err);\n    throw err;\n  }\n}\n"]}
+{"version":3,"file":"generate-prisma-json-schemas.js","sourceRoot":"","sources":["../../../../../../../src/modules/swagger/utils/helpers/json-schema-generators/generate-prisma-json-schemas.ts"],"names":[],"mappings":"AACA,OAAO,yBAAyB,MAAM,0DAA0D,CAAC;AACjG,OAAO,kBAAkB,MAAM,kDAAkD,CAAC;AAElF,MAAM,UAAU,yBAAyB,CAAC,WAAwB;IAChE,MAAM,kBAAkB,GAAG;QACzB,GAAG,kBAAkB,CAAC,yBAAyB,EAAE;QACjD,MAAM;KACP,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;YAC7D,MAAM,YAAY,GAAG,yBAAyB,CAAC,oBAAoB,CAAC;gBAClE,SAAS;gBACT,WAAW;aACZ,CAAC,CAAC;YACH,OAAO,YAAY,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE;YAC7D,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;QACrC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC","sourcesContent":["import { ArkosConfig } from \"../../../../../exports\";\nimport prismaJsonSchemaGenerator from \"../../../../../utils/prisma/prisma-json-schema-generator\";\nimport prismaSchemaParser from \"../../../../../utils/prisma/prisma-schema-parser\";\n\nexport function generatePrismaJsonSchemas(arkosConfig: ArkosConfig) {\n  const requiredAppModules = [\n    ...prismaSchemaParser.getModelsAsArrayOfStrings(),\n    \"auth\",\n  ];\n\n  try {\n    const modelSchemasArray = requiredAppModules.map((modelName) => {\n      const modelSchemas = prismaJsonSchemaGenerator.generateModelSchemas({\n        modelName,\n        arkosConfig,\n      });\n      return modelSchemas;\n    });\n\n    const schemas = modelSchemasArray.reduce((acc, modelSchemas) => {\n      return { ...acc, ...modelSchemas };\n    }, {});\n\n    return schemas;\n  } catch (err) {\n    console.error(err);\n    throw err;\n  }\n}\n"]}

package/dist/esm/modules/swagger/utils/helpers/json-schema-generators/generate-zod-json-schemas.js

@@ -2,7 +2,7 @@ import { getModuleComponents } from "../../../../../utils/dynamic-loader.js";
 import zodToJsonSchema from "zod-to-json-schema";
 import { getCorrectJsonSchemaName } from "../swagger.router.helpers.js";
 import prismaSchemaParser from "../../../../../utils/prisma/prisma-schema-parser.js";
-export default async function generateZodJsonSchemas() {
+export default function generateZodJsonSchemas() {
     const requiredAppModules = [
         ...prismaSchemaParser.getModelsAsArrayOfStrings(),
         "auth",

package/dist/esm/modules/swagger/utils/helpers/json-schema-generators/generate-zod-json-schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate-zod-json-schemas.js","sourceRoot":"","sources":["../../../../../../../src/modules/swagger/utils/helpers/json-schema-generators/generate-zod-json-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,eAAe,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,kBAAkB,MAAM,kDAAkD,CAAC;AAElF,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,sBAAsB;IAClD,MAAM,kBAAkB,GAAG;QACzB,GAAG,kBAAkB,CAAC,yBAAyB,EAAE;QACjD,MAAM;KACP,CAAC;IACF,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,kBAAkB,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QACvC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAExD,IAAI,gBAAgB,EAAE,OAAO;YAC3B,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,OAAO,CAC9C,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,EAAE;gBAC1B,IAAI,SAAS;oBACX,IAAI,CAAC;wBACH,MAAM,UAAU,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;wBAC9C,MAAM,UAAU,GAAG,wBAAwB,CACzC,UAAU,EACV,SAAS,EACT,QAAQ,CACT,CAAC;wBACF,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;oBACnC,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,IAAI,CACV,iCAAiC,UAAU,IAAI,SAAS,GAAG,EAC3D,KAAK,CACN,CAAC;oBACJ,CAAC;YACL,CAAC,CACF,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { getModuleComponents } from \"../../../../../utils/dynamic-loader\";\nimport zodToJsonSchema from \"zod-to-json-schema\";\nimport { getCorrectJsonSchemaName } from \"../swagger.router.helpers\";\nimport prismaSchemaParser from \"../../../../../utils/prisma/prisma-schema-parser\";\n\nexport default async function generateZodJsonSchemas() {\n  const requiredAppModules = [\n    ...prismaSchemaParser.getModelsAsArrayOfStrings(),\n    \"auth\",\n  ];\n  const schemas: Record<string, any> = {};\n\n  requiredAppModules.forEach((modelName) => {\n    const moduleComponents = getModuleComponents(modelName);\n\n    if (moduleComponents?.schemas)\n      Object.entries(moduleComponents.schemas).forEach(\n        ([schemaType, zodSchema]) => {\n          if (zodSchema)\n            try {\n              const jsonSchema = zodToJsonSchema(zodSchema);\n              const schemaName = getCorrectJsonSchemaName(\n                schemaType,\n                modelName,\n                \"Schema\"\n              );\n              schemas[schemaName] = jsonSchema;\n            } catch (error) {\n              console.warn(\n                `Failed to generate schema for ${schemaType} ${modelName}:`,\n                error\n              );\n            }\n        }\n      );\n  });\n\n  return schemas;\n}\n"]}
+{"version":3,"file":"generate-zod-json-schemas.js","sourceRoot":"","sources":["../../../../../../../src/modules/swagger/utils/helpers/json-schema-generators/generate-zod-json-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,eAAe,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,kBAAkB,MAAM,kDAAkD,CAAC;AAElF,MAAM,CAAC,OAAO,UAAU,sBAAsB;IAC5C,MAAM,kBAAkB,GAAG;QACzB,GAAG,kBAAkB,CAAC,yBAAyB,EAAE;QACjD,MAAM;KACP,CAAC;IACF,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,kBAAkB,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QACvC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAExD,IAAI,gBAAgB,EAAE,OAAO;YAC3B,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,OAAO,CAC9C,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,EAAE;gBAC1B,IAAI,SAAS;oBACX,IAAI,CAAC;wBACH,MAAM,UAAU,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;wBAC9C,MAAM,UAAU,GAAG,wBAAwB,CACzC,UAAU,EACV,SAAS,EACT,QAAQ,CACT,CAAC;wBACF,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;oBACnC,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,IAAI,CACV,iCAAiC,UAAU,IAAI,SAAS,GAAG,EAC3D,KAAK,CACN,CAAC;oBACJ,CAAC;YACL,CAAC,CACF,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { getModuleComponents } from \"../../../../../utils/dynamic-loader\";\nimport zodToJsonSchema from \"zod-to-json-schema\";\nimport { getCorrectJsonSchemaName } from \"../swagger.router.helpers\";\nimport prismaSchemaParser from \"../../../../../utils/prisma/prisma-schema-parser\";\n\nexport default function generateZodJsonSchemas() {\n  const requiredAppModules = [\n    ...prismaSchemaParser.getModelsAsArrayOfStrings(),\n    \"auth\",\n  ];\n  const schemas: Record<string, any> = {};\n\n  requiredAppModules.forEach((modelName) => {\n    const moduleComponents = getModuleComponents(modelName);\n\n    if (moduleComponents?.schemas)\n      Object.entries(moduleComponents.schemas).forEach(\n        ([schemaType, zodSchema]) => {\n          if (zodSchema)\n            try {\n              const jsonSchema = zodToJsonSchema(zodSchema);\n              const schemaName = getCorrectJsonSchemaName(\n                schemaType,\n                modelName,\n                \"Schema\"\n              );\n              schemas[schemaName] = jsonSchema;\n            } catch (error) {\n              console.warn(\n                `Failed to generate schema for ${schemaType} ${modelName}:`,\n                error\n              );\n            }\n        }\n      );\n  });\n\n  return schemas;\n}\n"]}