npm - arkos - Versions diffs - 1.4.0-canary.92 → 1.4.1-canary.2 - Mend

arkos 1.4.0-canary.92 → 1.4.1-canary.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (151) hide show

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

@@ -8,8 +8,8 @@ const dynamic_loader_1 = require("../../../../utils/dynamic-loader");
 const base_router_helpers_1 = require("../../../base/utils/helpers/base.router.helpers");
 const deepmerge_helper_1 = __importDefault(require("../../../../utils/helpers/deepmerge.helper"));
 const file_upload_service_1 = require("../../../file-upload/file-upload.service");
-function getFileUploadJsonSchemaPaths(arkosConfig) {
-    const paths = {};
+function getFileUploadJsonSchemaPaths(arkosConfig, existingPaths) {
+    const paths = { ...existingPaths };
     if (!arkosConfig.fileUpload)
         return paths;
     const FileUploadModuleComponents = (0, dynamic_loader_1.getModuleComponents)("file-upload");
@@ -60,359 +60,428 @@ function getFileUploadJsonSchemaPaths(arkosConfig) {
         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",
-                                },
+        const pathname = `${cleanBasePath}/{filePath*}`;
+        if (!paths[pathname])
+            paths[pathname] = {};
+        const currentPath = paths[pathname].get;
+        const defaultParameters = [
+            {
+                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)",
+            },
+        ];
+        const existingParams = currentPath?.parameters || [];
+        const existingParamKeys = new Set(existingParams.map((p) => `${p.in}-${p.name}`));
+        const mergedParameters = [
+            ...existingParams,
+            ...defaultParameters.filter((p) => !existingParamKeys.has(`${p.in}-${p.name}`)),
+        ];
+        const defaultSpec = {
+            tags: ["File Upload", ...(currentPath?.tags || [])].filter((tag) => tag !== "Defaults"),
+            summary: currentPath?.summary === pathname || !currentPath?.summary
+                ? "Retrieve uploaded file"
+                : currentPath?.summary,
+            description: currentPath?.description ||
+                `Serves static files from the upload directory (${baseUploadDir}). This endpoint uses wildcard path matching to serve files from any subdirectory.`,
+            operationId: currentPath?.operationId || "findFile",
+            ...(shouldIncludeSecurity("View") && {
+                security: [{ BearerAuth: [] }],
+            }),
+            parameters: mergedParameters,
+            responses: {
+                ...(currentPath?.responses || {}),
+                "200": currentPath?.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" },
-                    }),
                 },
+                "404": currentPath?.responses?.["404"] || {
+                    description: "File not found",
+                },
+                ...(shouldIncludeSecurity("View") && {
+                    "401": currentPath?.responses?.["401"] || {
+                        description: "Authentication required",
+                    },
+                    "403": currentPath?.responses?.["403"] || {
+                        description: "Insufficient permissions to view files",
+                    },
+                }),
             },
         };
+        paths[pathname].get = { ...(currentPath || {}), ...defaultSpec };
     }
     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,
+        const pathname = `${cleanBasePath}/{fileType}`;
+        if (!paths[pathname])
+            paths[pathname] = {};
+        const currentPath = paths[pathname].post;
+        const defaultParameters = [
+            {
+                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)",
+            },
+        ];
+        const existingParams = currentPath?.parameters || [];
+        const existingParamKeys = new Set(existingParams.map((p) => `${p.in}-${p.name}`));
+        const mergedParameters = [
+            ...existingParams,
+            ...defaultParameters.filter((p) => !existingParamKeys.has(`${p.in}-${p.name}`)),
+        ];
+        const defaultSpec = {
+            tags: ["File Upload", ...(currentPath?.tags || [])].filter((tag) => tag !== "Defaults"),
+            summary: currentPath?.summary === pathname || !currentPath?.summary
+                ? "Upload file(s)"
+                : currentPath?.summary,
+            description: currentPath?.description ||
+                "Upload one or multiple files. Supports image processing options for image uploads.",
+            operationId: currentPath?.operationId || "uploadFile",
+            ...(shouldIncludeSecurity("Create") && {
+                security: [{ BearerAuth: [] }],
+            }),
+            parameters: mergedParameters,
+            requestBody: currentPath?.requestBody || {
+                required: true,
+                content: {
+                    "multipart/form-data": {
                         schema: {
-                            type: "string",
-                            enum: ["cover", "contain", "fill", "inside", "outside"],
+                            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"),
+                                },
+                            },
                         },
-                        description: "Resize strategy (only applicable for fileType=images)",
                     },
-                ],
-                requestBody: {
-                    required: true,
+                },
+            },
+            responses: {
+                ...(currentPath?.responses || {}),
+                "200": currentPath?.responses?.["200"] || {
+                    description: "File(s) uploaded successfully",
                     content: {
-                        "multipart/form-data": {
+                        "application/json": {
                             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"),
+                                    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" },
                                 },
                             },
                         },
                     },
                 },
-                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": currentPath?.responses?.["400"] || {
+                    description: "Invalid file type, size limit exceeded, or no file uploaded",
+                },
+                ...(shouldIncludeSecurity("Create") && {
+                    "401": currentPath?.responses?.["401"] || {
+                        description: "Authentication required",
                     },
-                    "400": {
-                        description: "Invalid file type, size limit exceeded, or no file uploaded",
+                    "403": currentPath?.responses?.["403"] || {
+                        description: "Insufficient permissions to upload files",
                     },
-                    ...(shouldIncludeSecurity("Create") && {
-                        "401": { description: "Authentication required" },
-                        "403": { description: "Insufficient permissions to upload files" },
-                    }),
-                },
+                }),
             },
         };
+        paths[pathname].post = { ...(currentPath || {}), ...defaultSpec };
     }
     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,
+        const pathname = `${cleanBasePath}/{fileType}/{fileName}`;
+        if (!paths[pathname])
+            paths[pathname] = {};
+        const currentPath = paths[pathname].patch;
+        const defaultParameters = [
+            {
+                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)",
+            },
+        ];
+        const existingParams = currentPath?.parameters || [];
+        const existingParamKeys = new Set(existingParams.map((p) => `${p.in}-${p.name}`));
+        const mergedParameters = [
+            ...existingParams,
+            ...defaultParameters.filter((p) => !existingParamKeys.has(`${p.in}-${p.name}`)),
+        ];
+        const defaultSpec = {
+            tags: ["File Upload", ...(currentPath?.tags || [])].filter((tag) => tag !== "Defaults"),
+            summary: currentPath?.summary === pathname || !currentPath?.summary
+                ? "Update existing file"
+                : currentPath?.summary,
+            description: currentPath?.description ||
+                "Replace an existing file with a new one. Deletes the old file and uploads the new one.",
+            operationId: currentPath?.operationId || "updateFile",
+            ...(shouldIncludeSecurity("Update") && {
+                security: [{ BearerAuth: [] }],
+            }),
+            parameters: mergedParameters,
+            requestBody: currentPath?.requestBody || {
+                required: true,
+                content: {
+                    "multipart/form-data": {
                         schema: {
-                            type: "string",
-                            enum: ["cover", "contain", "fill", "inside", "outside"],
+                            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"),
+                                },
+                            },
                         },
-                        description: "Resize strategy (only applicable for fileType=images)",
                     },
-                ],
-                requestBody: {
-                    required: true,
+                },
+            },
+            responses: {
+                ...(currentPath?.responses || {}),
+                "200": currentPath?.responses?.["200"] || {
+                    description: "File updated successfully",
                     content: {
-                        "multipart/form-data": {
+                        "application/json": {
                             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"),
+                                    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" },
                                 },
                             },
                         },
                     },
                 },
-                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",
+                "400": currentPath?.responses?.["400"] || {
+                    description: "Invalid file type, size limit exceeded, or no file uploaded",
+                },
+                "404": currentPath?.responses?.["404"] || {
+                    description: "Original file not found",
+                },
+                ...(shouldIncludeSecurity("Update") && {
+                    "401": currentPath?.responses?.["401"] || {
+                        description: "Authentication required",
                     },
-                    "404": {
-                        description: "Original file not found",
+                    "403": currentPath?.responses?.["403"] || {
+                        description: "Insufficient permissions to update files",
                     },
-                    ...(shouldIncludeSecurity("Update") && {
-                        "401": { description: "Authentication required" },
-                        "403": { description: "Insufficient permissions to update files" },
-                    }),
-                },
+                }),
             },
         };
+        paths[pathname].patch = { ...(currentPath || {}), ...defaultSpec };
     }
     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",
+        const pathname = `${cleanBasePath}/{fileType}/{fileName}`;
+        if (!paths[pathname])
+            paths[pathname] = {};
+        const currentPath = paths[pathname].delete;
+        const defaultParameters = [
+            {
+                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",
+            },
+        ];
+        const existingParams = currentPath?.parameters || [];
+        const existingParamKeys = new Set(existingParams.map((p) => `${p.in}-${p.name}`));
+        const mergedParameters = [
+            ...existingParams,
+            ...defaultParameters.filter((p) => !existingParamKeys.has(`${p.in}-${p.name}`)),
+        ];
+        const defaultSpec = {
+            tags: ["File Upload", ...(currentPath?.tags || [])].filter((tag) => tag !== "Defaults"),
+            summary: currentPath?.summary === pathname || !currentPath?.summary
+                ? "Delete file"
+                : currentPath?.summary,
+            description: currentPath?.description || "Delete an uploaded file from the server",
+            operationId: currentPath?.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",
-                },
-            ],
+            parameters: mergedParameters,
             responses: {
-                "204": {
+                ...(currentPath?.responses || {}),
+                "204": currentPath?.responses?.["204"] || {
                     description: "File deleted successfully",
                 },
-                "404": {
+                "404": currentPath?.responses?.["404"] || {
                     description: "File not found",
                 },
                 ...(shouldIncludeSecurity("Delete") && {
-                    "401": { description: "Authentication required" },
-                    "403": { description: "Insufficient permissions to delete files" },
+                    "401": currentPath?.responses?.["401"] || {
+                        description: "Authentication required",
+                    },
+                    "403": currentPath?.responses?.["403"] || {
+                        description: "Insufficient permissions to delete files",
+                    },
                 }),
             },
         };
+        paths[pathname].delete = { ...(currentPath || {}), ...defaultSpec };
     }
     return paths;
 }