arkos 2.0.0-next.3 → 2.0.0-next.30

package/dist/esm/modules/file-upload/utils/file-upload-json-schema-generator.js

@@ -0,0 +1,371 @@
+import { getArkosConfig } from "../../../utils/helpers/arkos-config.helpers.js";
+import deepmerge from "../../../utils/helpers/deepmerge.helper.js";
+import { fileUploadDefaultRestrictions } from "../file-upload.service.js";
+class FileUploadJsonSchemaGenerator {
+    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];
+    }
+    getFileTypeDescription(fileType) {
+        const arkosConfig = getArkosConfig();
+        const restrictions = deepmerge(fileUploadDefaultRestrictions, arkosConfig.fileUpload?.restrictions || {});
+        const restriction = restrictions[fileType];
+        if (!restriction)
+            return "";
+        const maxSize = this.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}`;
+    }
+    getMultipartRequestBody() {
+        return {
+            required: true,
+            content: {
+                "multipart/form-data": {
+                    schema: {
+                        type: "object",
+                        properties: {
+                            images: {
+                                type: "array",
+                                items: { type: "string", format: "binary" },
+                                description: this.getFileTypeDescription("images"),
+                            },
+                            videos: {
+                                type: "array",
+                                items: { type: "string", format: "binary" },
+                                description: this.getFileTypeDescription("videos"),
+                            },
+                            documents: {
+                                type: "array",
+                                items: { type: "string", format: "binary" },
+                                description: this.getFileTypeDescription("documents"),
+                            },
+                            files: {
+                                type: "array",
+                                items: { type: "string", format: "binary" },
+                                description: this.getFileTypeDescription("files"),
+                            },
+                        },
+                    },
+                },
+            },
+        };
+    }
+    getImageQueryParameters() {
+        return [
+            {
+                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: "integer", minimum: 1 },
+                description: "Target size in pixels to fit within, keeps aspect ratio (only applicable for fileType=images)",
+            },
+            {
+                name: "quality",
+                in: "query",
+                required: false,
+                schema: { type: "integer", minimum: 1, maximum: 100 },
+                description: "Output quality for lossy formats like webp/jpeg/avif (only applicable for fileType=images)",
+            },
+        ];
+    }
+    getOpenApiConfig(endpointRouterConfig = {}, endpoint) {
+        const arkosConfig = getArkosConfig();
+        const basePathname = arkosConfig.fileUpload?.baseRoute || "/api/uploads/";
+        const cleanBasePath = basePathname.endsWith("/")
+            ? basePathname.slice(0, -1)
+            : basePathname;
+        const existingOpenApi = endpointRouterConfig?.experimental?.openapi || {};
+        switch (endpoint) {
+            case "findFile": {
+                const isRegistered = arkosConfig.fileUpload?.serving === "registered";
+                const pathname = isRegistered
+                    ? `${cleanBasePath}/:fileType/*`
+                    : `${cleanBasePath}/*`;
+                return {
+                    ...existingOpenApi,
+                    tags: ["File Upload", ...(existingOpenApi?.tags || [])].filter((tag) => tag !== "Defaults"),
+                    summary: existingOpenApi?.summary === pathname || !existingOpenApi?.summary
+                        ? "Retrieve uploaded file"
+                        : existingOpenApi.summary,
+                    description: existingOpenApi?.description ||
+                        (isRegistered
+                            ? `Serves files from the registered upload directories (${arkosConfig.fileUpload?.baseUploadDir || "uploads"}/images, videos, documents, files).`
+                            : `Serves static files from the upload directory (${arkosConfig.fileUpload?.baseUploadDir || "uploads"}). Uses wildcard path matching to serve files from any subdirectory.`),
+                    operationId: existingOpenApi?.operationId?.includes(pathname) ||
+                        !existingOpenApi?.operationId
+                        ? "findFile"
+                        : existingOpenApi.operationId,
+                    parameters: [
+                        ...(existingOpenApi?.parameters || []),
+                        ...[
+                            ...(isRegistered
+                                ? [
+                                    {
+                                        name: "fileType",
+                                        in: "path",
+                                        required: true,
+                                        schema: {
+                                            type: "string",
+                                            enum: ["images", "videos", "documents", "files"],
+                                        },
+                                        description: "Type of file being retrieved",
+                                    },
+                                ]
+                                : []),
+                            {
+                                name: "slug",
+                                in: "path",
+                                required: true,
+                                schema: { type: "string" },
+                                description: isRegistered
+                                    ? "Path to the file within the file type directory (e.g., photo.jpg)"
+                                    : "Path to the file including file type directory (e.g., images/photo.jpg)",
+                            },
+                        ].filter((p) => !(existingOpenApi?.parameters || []).find((ep) => ep.name === p.name && ep.in === p.in)),
+                    ],
+                    responses: {
+                        ...(existingOpenApi?.responses || {}),
+                        "200": existingOpenApi?.responses?.["200"] || {
+                            description: "File retrieved successfully",
+                            content: {
+                                "application/octet-stream": {
+                                    schema: { type: "string", format: "binary" },
+                                },
+                            },
+                        },
+                        "404": existingOpenApi?.responses?.["404"] || {
+                            description: "File not found",
+                        },
+                    },
+                };
+            }
+            case "uploadFile": {
+                const pathname = `${cleanBasePath}/:fileType`;
+                return {
+                    ...existingOpenApi,
+                    tags: ["File Upload", ...(existingOpenApi?.tags || [])].filter((tag) => tag !== "Defaults"),
+                    summary: existingOpenApi?.summary === pathname || !existingOpenApi?.summary
+                        ? "Upload file(s)"
+                        : existingOpenApi.summary,
+                    description: existingOpenApi?.description ||
+                        "Upload one or multiple files. Supports image processing options for image uploads.",
+                    operationId: existingOpenApi?.operationId?.includes(pathname) ||
+                        !existingOpenApi?.operationId
+                        ? "uploadFile"
+                        : existingOpenApi.operationId,
+                    parameters: [
+                        ...(existingOpenApi?.parameters || []),
+                        ...[
+                            {
+                                name: "fileType",
+                                in: "path",
+                                required: true,
+                                schema: {
+                                    type: "string",
+                                    enum: ["images", "videos", "documents", "files"],
+                                },
+                                description: "Type of file being uploaded",
+                            },
+                            ...this.getImageQueryParameters(),
+                        ].filter((p) => !(existingOpenApi?.parameters || []).find((ep) => ep.name === p.name && ep.in === p.in)),
+                    ],
+                    requestBody: existingOpenApi?.requestBody || this.getMultipartRequestBody(),
+                    responses: {
+                        ...(existingOpenApi?.responses || {}),
+                        "200": existingOpenApi?.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": existingOpenApi?.responses?.["400"] || {
+                            description: "Invalid file type, size limit exceeded, or no file uploaded",
+                        },
+                    },
+                };
+            }
+            case "updateFile": {
+                const pathname = `${cleanBasePath}/:fileType/:fileName(.+)`;
+                return {
+                    ...existingOpenApi,
+                    tags: ["File Upload", ...(existingOpenApi?.tags || [])].filter((tag) => tag !== "Defaults"),
+                    summary: existingOpenApi?.summary === pathname || !existingOpenApi?.summary
+                        ? "Update existing file"
+                        : existingOpenApi.summary,
+                    description: existingOpenApi?.description ||
+                        "Replace an existing file with a new one. Deletes the old file and uploads the new one.",
+                    operationId: existingOpenApi?.operationId?.includes(pathname) ||
+                        !existingOpenApi?.operationId
+                        ? "updateFile"
+                        : existingOpenApi.operationId,
+                    parameters: [
+                        ...(existingOpenApi?.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, including its subdirectory (e.g., profile/photo.jpg)",
+                            },
+                            ...this.getImageQueryParameters(),
+                        ].filter((p) => !(existingOpenApi?.parameters || []).find((ep) => ep.name === p.name && ep.in === p.in)),
+                    ],
+                    requestBody: existingOpenApi?.requestBody || this.getMultipartRequestBody(),
+                    responses: {
+                        ...(existingOpenApi?.responses || {}),
+                        "200": existingOpenApi?.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": existingOpenApi?.responses?.["400"] || {
+                            description: "Invalid file type, size limit exceeded, or no file uploaded",
+                        },
+                        "404": existingOpenApi?.responses?.["404"] || {
+                            description: "Original file not found",
+                        },
+                    },
+                };
+            }
+            case "deleteFile": {
+                const pathname = `${cleanBasePath}/:fileType/:fileName(.+)`;
+                return {
+                    ...existingOpenApi,
+                    tags: ["File Upload", ...(existingOpenApi?.tags || [])].filter((tag) => tag !== "Defaults"),
+                    summary: existingOpenApi?.summary === pathname || !existingOpenApi?.summary
+                        ? "Delete file"
+                        : existingOpenApi.summary,
+                    description: existingOpenApi?.description ||
+                        "Delete an uploaded file from the server",
+                    operationId: existingOpenApi?.operationId?.includes(pathname) ||
+                        !existingOpenApi?.operationId
+                        ? "deleteFile"
+                        : existingOpenApi.operationId,
+                    parameters: [
+                        ...(existingOpenApi?.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, including its subdirectory (e.g., profile/photo.jpg)",
+                            },
+                        ].filter((p) => !(existingOpenApi?.parameters || []).find((ep) => ep.name === p.name && ep.in === p.in)),
+                    ],
+                    responses: {
+                        ...(existingOpenApi?.responses || {}),
+                        "204": existingOpenApi?.responses?.["204"] || {
+                            description: "File deleted successfully",
+                        },
+                        "404": existingOpenApi?.responses?.["404"] || {
+                            description: "File not found",
+                        },
+                    },
+                };
+            }
+            default:
+                return {};
+        }
+    }
+}
+const fileUploadJsonSchemaGenerator = new FileUploadJsonSchemaGenerator();
+export default fileUploadJsonSchemaGenerator;
+//# sourceMappingURL=file-upload-json-schema-generator.js.map

package/dist/esm/modules/file-upload/utils/file-upload-json-schema-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-upload-json-schema-generator.js","sourceRoot":"","sources":["../../../../../src/modules/file-upload/utils/file-upload-json-schema-generator.ts"],"names":[],"mappings":"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","sourcesContent":["import { OpenAPIV3 } from \"openapi-types\";\nimport { getArkosConfig } from \"../../../utils/helpers/arkos-config.helpers\";\nimport deepmerge from \"../../../utils/helpers/deepmerge.helper\";\nimport { fileUploadDefaultRestrictions } from \"../file-upload.service\";\nimport { FileUploadRouterEndpoint } from \"../../../types/router-config\";\nimport { ArkosRouteConfig } from \"../../../exports\";\nimport { ExtendedOperationObject } from \"../../../utils/arkos-router/types/openapi-config\";\n\nclass FileUploadJsonSchemaGenerator {\n  private 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  private getFileTypeDescription(fileType: string): string {\n    const arkosConfig = getArkosConfig();\n    const restrictions = deepmerge(\n      fileUploadDefaultRestrictions,\n      arkosConfig.fileUpload?.restrictions || {}\n    );\n\n    const restriction = restrictions[fileType as keyof typeof restrictions];\n    if (!restriction) return \"\";\n\n    const maxSize = this.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  private getMultipartRequestBody(): OpenAPIV3.RequestBodyObject {\n    return {\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: this.getFileTypeDescription(\"images\"),\n              },\n              videos: {\n                type: \"array\",\n                items: { type: \"string\", format: \"binary\" },\n                description: this.getFileTypeDescription(\"videos\"),\n              },\n              documents: {\n                type: \"array\",\n                items: { type: \"string\", format: \"binary\" },\n                description: this.getFileTypeDescription(\"documents\"),\n              },\n              files: {\n                type: \"array\",\n                items: { type: \"string\", format: \"binary\" },\n                description: this.getFileTypeDescription(\"files\"),\n              },\n            },\n          },\n        },\n      },\n    };\n  }\n\n  private getImageQueryParameters(): OpenAPIV3.ParameterObject[] {\n    return [\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: { type: \"integer\", minimum: 1 },\n        description:\n          \"Target size in pixels to fit within, keeps aspect ratio (only applicable for fileType=images)\",\n      },\n      {\n        name: \"quality\",\n        in: \"query\",\n        required: false,\n        schema: { type: \"integer\", minimum: 1, maximum: 100 },\n        description:\n          \"Output quality for lossy formats like webp/jpeg/avif (only applicable for fileType=images)\",\n      },\n    ];\n  }\n\n  getOpenApiConfig(\n    endpointRouterConfig: Omit<ArkosRouteConfig, \"path\"> = {},\n    endpoint: FileUploadRouterEndpoint\n  ): Partial<ExtendedOperationObject> {\n    const arkosConfig = getArkosConfig();\n    const basePathname = arkosConfig.fileUpload?.baseRoute || \"/api/uploads/\";\n    const cleanBasePath = basePathname.endsWith(\"/\")\n      ? basePathname.slice(0, -1)\n      : basePathname;\n\n    const existingOpenApi = endpointRouterConfig?.experimental?.openapi || {};\n\n    switch (endpoint) {\n      case \"findFile\": {\n        const isRegistered = arkosConfig.fileUpload?.serving === \"registered\";\n        const pathname = isRegistered\n          ? `${cleanBasePath}/:fileType/*`\n          : `${cleanBasePath}/*`;\n        return {\n          ...existingOpenApi,\n          tags: [\"File Upload\", ...(existingOpenApi?.tags || [])].filter(\n            (tag) => tag !== \"Defaults\"\n          ),\n          summary:\n            existingOpenApi?.summary === pathname || !existingOpenApi?.summary\n              ? \"Retrieve uploaded file\"\n              : existingOpenApi.summary,\n          description:\n            existingOpenApi?.description ||\n            (isRegistered\n              ? `Serves files from the registered upload directories (${arkosConfig.fileUpload?.baseUploadDir || \"uploads\"}/images, videos, documents, files).`\n              : `Serves static files from the upload directory (${arkosConfig.fileUpload?.baseUploadDir || \"uploads\"}). Uses wildcard path matching to serve files from any subdirectory.`),\n          operationId:\n            existingOpenApi?.operationId?.includes(pathname) ||\n              !existingOpenApi?.operationId\n              ? \"findFile\"\n              : existingOpenApi.operationId,\n          parameters: [\n            ...(existingOpenApi?.parameters || []),\n            ...(\n              [\n                ...(isRegistered\n                  ? [\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 retrieved\",\n                      },\n                    ]\n                  : []),\n                {\n                  name: \"slug\",\n                  in: \"path\",\n                  required: true,\n                  schema: { type: \"string\" },\n                  description: isRegistered\n                    ? \"Path to the file within the file type directory (e.g., photo.jpg)\"\n                    : \"Path to the file including file type directory (e.g., images/photo.jpg)\",\n                },\n              ] as OpenAPIV3.ParameterObject[]\n            ).filter(\n              (p) =>\n                !(existingOpenApi?.parameters || []).find(\n                  (ep: any) => ep.name === p.name && ep.in === p.in\n                )\n            ),\n          ],\n          responses: {\n            ...(existingOpenApi?.responses || {}),\n            \"200\": existingOpenApi?.responses?.[\"200\"] || {\n              description: \"File retrieved successfully\",\n              content: {\n                \"application/octet-stream\": {\n                  schema: { type: \"string\", format: \"binary\" },\n                },\n              },\n            },\n            \"404\": existingOpenApi?.responses?.[\"404\"] || {\n              description: \"File not found\",\n            },\n          },\n        };\n      }\n\n      case \"uploadFile\": {\n        const pathname = `${cleanBasePath}/:fileType`;\n        return {\n          ...existingOpenApi,\n          tags: [\"File Upload\", ...(existingOpenApi?.tags || [])].filter(\n            (tag) => tag !== \"Defaults\"\n          ),\n          summary:\n            existingOpenApi?.summary === pathname || !existingOpenApi?.summary\n              ? \"Upload file(s)\"\n              : existingOpenApi.summary,\n          description:\n            existingOpenApi?.description ||\n            \"Upload one or multiple files. Supports image processing options for image uploads.\",\n          operationId:\n            existingOpenApi?.operationId?.includes(pathname) ||\n              !existingOpenApi?.operationId\n              ? \"uploadFile\"\n              : existingOpenApi.operationId,\n          parameters: [\n            ...(existingOpenApi?.parameters || []),\n            ...(\n              [\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                ...this.getImageQueryParameters(),\n              ] as OpenAPIV3.ParameterObject[]\n            ).filter(\n              (p) =>\n                !(existingOpenApi?.parameters || []).find(\n                  (ep: any) => ep.name === p.name && ep.in === p.in\n                )\n            ),\n          ],\n          requestBody:\n            existingOpenApi?.requestBody || this.getMultipartRequestBody(),\n          responses: {\n            ...(existingOpenApi?.responses || {}),\n            \"200\": existingOpenApi?.responses?.[\"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                          {\n                            type: \"string\",\n                            description: \"URL of uploaded file\",\n                          },\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\": existingOpenApi?.responses?.[\"400\"] || {\n              description:\n                \"Invalid file type, size limit exceeded, or no file uploaded\",\n            },\n          },\n        };\n      }\n\n      case \"updateFile\": {\n        const pathname = `${cleanBasePath}/:fileType/:fileName(.+)`;\n        return {\n          ...existingOpenApi,\n          tags: [\"File Upload\", ...(existingOpenApi?.tags || [])].filter(\n            (tag) => tag !== \"Defaults\"\n          ),\n          summary:\n            existingOpenApi?.summary === pathname || !existingOpenApi?.summary\n              ? \"Update existing file\"\n              : existingOpenApi.summary,\n          description:\n            existingOpenApi?.description ||\n            \"Replace an existing file with a new one. Deletes the old file and uploads the new one.\",\n          operationId:\n            existingOpenApi?.operationId?.includes(pathname) ||\n              !existingOpenApi?.operationId\n              ? \"updateFile\"\n              : existingOpenApi.operationId,\n          parameters: [\n            ...(existingOpenApi?.parameters || []),\n            ...(\n              [\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:\n                    \"Name of the file to update, including its subdirectory (e.g., profile/photo.jpg)\",\n                },\n                ...this.getImageQueryParameters(),\n              ] as OpenAPIV3.ParameterObject[]\n            ).filter(\n              (p) =>\n                !(existingOpenApi?.parameters || []).find(\n                  (ep: any) => ep.name === p.name && ep.in === p.in\n                )\n            ),\n          ],\n          requestBody:\n            existingOpenApi?.requestBody || this.getMultipartRequestBody(),\n          responses: {\n            ...(existingOpenApi?.responses || {}),\n            \"200\": existingOpenApi?.responses?.[\"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                          {\n                            type: \"string\",\n                            description: \"URL of updated file\",\n                          },\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\": existingOpenApi?.responses?.[\"400\"] || {\n              description:\n                \"Invalid file type, size limit exceeded, or no file uploaded\",\n            },\n            \"404\": existingOpenApi?.responses?.[\"404\"] || {\n              description: \"Original file not found\",\n            },\n          },\n        };\n      }\n\n      case \"deleteFile\": {\n        const pathname = `${cleanBasePath}/:fileType/:fileName(.+)`;\n        return {\n          ...existingOpenApi,\n          tags: [\"File Upload\", ...(existingOpenApi?.tags || [])].filter(\n            (tag) => tag !== \"Defaults\"\n          ),\n          summary:\n            existingOpenApi?.summary === pathname || !existingOpenApi?.summary\n              ? \"Delete file\"\n              : existingOpenApi.summary,\n          description:\n            existingOpenApi?.description ||\n            \"Delete an uploaded file from the server\",\n          operationId:\n            existingOpenApi?.operationId?.includes(pathname) ||\n              !existingOpenApi?.operationId\n              ? \"deleteFile\"\n              : existingOpenApi.operationId,\n          parameters: [\n            ...(existingOpenApi?.parameters || []),\n            ...(\n              [\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:\n                    \"Name of the file to delete, including its subdirectory (e.g., profile/photo.jpg)\",\n                },\n              ] as OpenAPIV3.ParameterObject[]\n            ).filter(\n              (p) =>\n                !(existingOpenApi?.parameters || []).find(\n                  (ep: any) => ep.name === p.name && ep.in === p.in\n                )\n            ),\n          ],\n          responses: {\n            ...(existingOpenApi?.responses || {}),\n            \"204\": existingOpenApi?.responses?.[\"204\"] || {\n              description: \"File deleted successfully\",\n            },\n            \"404\": existingOpenApi?.responses?.[\"404\"] || {\n              description: \"File not found\",\n            },\n          },\n        };\n      }\n\n      default:\n        return {};\n    }\n  }\n}\n\nconst fileUploadJsonSchemaGenerator = new FileUploadJsonSchemaGenerator();\n\nexport default fileUploadJsonSchemaGenerator;\n"]}

package/dist/esm/modules/file-upload/utils/helpers/file-upload.helpers.js

@@ -5,7 +5,6 @@ import { promisify } from "util";
 import { getArkosConfig } from "../../../../server.js";
 import mimetype from "mimetype";
 import { fullCleanCwd } from "../../../../utils/helpers/fs.helpers.js";
-import AppError from "../../../error-handler/utils/app-error.js";
 export function adjustRequestUrl(req, _, next) {
     const { fileUpload } = getArkosConfig();
     req.url = req.url.replace(fileUpload?.baseRoute + "/" || "/api/uploads/", "/");
@@ -29,11 +28,11 @@ export function generateRelativePath(filePath, uploadDir) {
     }
     else {
         return fullCleanCwd(filePath)
-            .replace(`${baseUploadDir}/`, "")
-            .replace(`/${baseUploadDir}/`, "")
+            .replaceAll("\\", "/")
+            .replace(`${baseUploadDir}/`, "/")
+            .replace(`/${baseUploadDir}/`, "/")
             .replace(`/${baseUploadDir}`, "")
             .replace(`${baseUploadDir}`, "")
-            .replaceAll("\\", "/")
             .replaceAll("//", "/");
     }
 }
@@ -42,47 +41,86 @@ export const processFile = (req, filePath) => {
     const relativePath = generateRelativePath(filePath, req.params.fileType).replace(/\\/g, "/");
     return `${baseURL}${baseRoute === "/" ? "" : baseRoute}${relativePath.startsWith("/") ? relativePath : `/${relativePath}`}`;
 };
-export const processImage = async (req, next, filePath, options) => {
+const SHARP_FORMATS = new Set([
+    "jpeg",
+    "jpg",
+    "png",
+    "webp",
+    "avif",
+    "tiff",
+    "tif",
+    "gif",
+    "heif",
+    "heic",
+]);
+const QUALITY_FORMATS = new Set(["jpeg", "webp", "avif"]);
+const toPositiveInt = (value) => {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) && parsed > 0 ? Math.round(parsed) : undefined;
+};
+const removeFile = async (target) => {
+    try {
+        await promisify(fs.unlink)(target);
+    }
+    catch { }
+};
+export const optimizeImage = async (filePath, options = {}) => {
+    if (options.optimize === false)
+        return filePath;
     const ext = path.extname(filePath).toLowerCase();
-    const originalFormat = ext.replace(".", "");
-    const outputFormat = options.format || originalFormat;
-    if (!mimetype.lookup(ext)?.includes?.("image"))
-        return processFile(req, filePath);
-    const tempName = `${path.basename(filePath, ext)}_${Date.now()}${ext}`;
-    const tempPath = path.join(path.dirname(filePath), tempName);
+    const outputFormat = (options.format || "webp").toLowerCase();
+    const sharpFormat = outputFormat === "jpg" ? "jpeg" : outputFormat;
+    const directory = path.dirname(filePath);
+    const baseName = path.basename(filePath, ext);
+    const finalPath = path.join(directory, `${baseName}.${outputFormat}`);
+    const tempPath = path.join(directory, `${baseName}.${Date.now()}-${Math.round(Math.random() * 1e9)}.${outputFormat}`);
     try {
-        let transformer = sharp(filePath);
-        const metadata = await transformer.metadata();
-        if (options.resizeTo && metadata.width && metadata.height) {
-            const targetSize = options.resizeTo;
-            const scaleFactor = targetSize / Math.min(metadata.width, metadata.height);
-            const newWidth = Math.round(metadata.width * scaleFactor);
-            const newHeight = Math.round(metadata.height * scaleFactor);
-            transformer = transformer.resize(newWidth, newHeight);
-        }
-        else if (options.width || options.height) {
-            transformer = transformer.resize(options.width || null, options.height || null, {
-                fit: "inside",
+        const width = toPositiveInt(options.width);
+        const height = toPositiveInt(options.height);
+        const resizeTo = toPositiveInt(options.resizeTo);
+        const quality = toPositiveInt(options.quality);
+        let transformer = sharp(filePath).rotate();
+        if (resizeTo)
+            transformer = transformer.resize(resizeTo, resizeTo, {
+                fit: options.fit || "inside",
+                withoutEnlargement: options.withoutEnlargement ?? true,
+            });
+        else if (width || height)
+            transformer = transformer.resize(width || null, height || null, {
+                fit: options.fit || "inside",
+                ...(options.withoutEnlargement !== undefined && {
+                    withoutEnlargement: options.withoutEnlargement,
+                }),
             });
+        if (SHARP_FORMATS.has(sharpFormat)) {
+            const formatOptions = quality && QUALITY_FORMATS.has(sharpFormat) ? { quality } : {};
+            transformer = transformer.toFormat(sharpFormat, formatOptions);
         }
-        if (outputFormat === "webp")
-            transformer = transformer.toFormat("webp");
-        else if (outputFormat === "jpeg" || outputFormat === "jpg")
-            transformer = transformer.toFormat("jpeg");
         await transformer.toFile(tempPath);
-        await promisify(fs.rename)(tempPath, filePath);
+        await removeFile(filePath);
+        if (tempPath !== finalPath)
+            await promisify(fs.rename)(tempPath, finalPath);
+        return finalPath;
+    }
+    catch (error) {
+        await removeFile(tempPath);
+        throw error;
+    }
+};
+export const processImage = async (req, next, filePath, options = {}) => {
+    const ext = path.extname(filePath).toLowerCase();
+    if (!mimetype.lookup(ext)?.includes?.("image"))
         return processFile(req, filePath);
+    try {
+        const optimizedPath = await optimizeImage(filePath, options);
+        return processFile(req, optimizedPath);
     }
     catch (error) {
-        try {
-            await promisify(fs.stat)(tempPath);
-            await promisify(fs.unlink)(tempPath);
-        }
-        catch (err) {
-        }
         if (error.message === "Input file contains unsupported image format")
             return processFile(req, filePath);
-        next(new AppError(error.message, 400, "CannotProcessImage", { error }));
+        next(new Error(`Cannot process uploaded image: ${error.message}`));
         return null;
     }
 };

package/dist/esm/modules/file-upload/utils/helpers/file-upload.helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-upload.helpers.js","sourceRoot":"","sources":["../../../../../../src/modules/file-upload/utils/helpers/file-upload.helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"fs\";\nimport path from \"path\";\nimport sharp from \"sharp\";\nimport { promisify } from \"util\";\nimport { getArkosConfig } from \"../../../../server\";\nimport mimetype from \"mimetype\";\nimport {\n  ArkosNextFunction,\n  ArkosRequest,\n  ArkosResponse,\n} from \"../../../../types\";\nimport { fullCleanCwd } from \"../../../../utils/helpers/fs.helpers\";\nimport AppError from \"../../../error-handler/utils/app-error\";\n\nexport function adjustRequestUrl(\n  req: ArkosRequest,\n  _: ArkosResponse,\n  next: ArkosNextFunction\n) {\n  const { fileUpload } = getArkosConfig();\n  req.url = req.url.replace(\n    fileUpload?.baseRoute + \"/\" || \"/api/uploads/\",\n    \"/\"\n  );\n  req.url = req.url.replace(fileUpload?.baseRoute || \"/api/uploads/\", \"/\");\n  next();\n}\n\nexport function extractRequestInfo(req: ArkosRequest) {\n  const { fileUpload } = getArkosConfig();\n\n  // Determine the base URL for file access\n  const protocol =\n    req.secure || req.headers[\"x-forwarded-proto\"] === \"https\"\n      ? \"https\"\n      : \"http\";\n  const baseURL = `${protocol}://${req.get?.(\"host\")}`;\n  const baseRoute = fileUpload?.baseRoute || \"/api/uploads\";\n  return { baseURL, baseRoute };\n}\n\n/**\n * Generates the correct relative path regardless of upload directory location\n */\nexport function generateRelativePath(filePath: string, uploadDir: string) {\n  const { fileUpload } = getArkosConfig();\n\n  const baseUploadDir = fileUpload?.baseUploadDir || \"/uploads\";\n  if (baseUploadDir.startsWith(\"..\")) {\n    return path.join(uploadDir, path.basename(filePath));\n  } else {\n    return fullCleanCwd(filePath)\n      .replace(`${baseUploadDir}/`, \"\")\n      .replace(`/${baseUploadDir}/`, \"\")\n      .replace(`/${baseUploadDir}`, \"\")\n      .replace(`${baseUploadDir}`, \"\")\n      .replaceAll(\"\\\\\", \"/\")\n      .replaceAll(\"//\", \"/\");\n  }\n}\n\n/**\n * Handles basic file processing for non-image files\n */\nexport const processFile = (req: ArkosRequest, filePath: string): string => {\n  const { baseURL, baseRoute } = extractRequestInfo(req);\n\n  const relativePath = generateRelativePath(\n    filePath,\n    req.params!.fileType\n  ).replace(/\\\\/g, \"/\");\n\n  return `${baseURL}${baseRoute === \"/\" ? \"\" : baseRoute}${\n    relativePath.startsWith(\"/\") ? relativePath : `/${relativePath}`\n  }`;\n};\n\n/**\n * Processes image files using Sharp for resizing and format conversion\n */\nexport const processImage = async (\n  req: ArkosRequest,\n  next: ArkosNextFunction,\n  filePath: string,\n  options: Record<string, any>\n): Promise<string | null> => {\n  const ext = path.extname(filePath).toLowerCase();\n  const originalFormat = ext.replace(\".\", \"\");\n  const outputFormat = options.format || originalFormat;\n\n  if (!mimetype.lookup(ext)?.includes?.(\"image\"))\n    return processFile(req, filePath);\n\n  const tempName = `${path.basename(filePath, ext)}_${Date.now()}${ext}`;\n  const tempPath = path.join(path.dirname(filePath), tempName);\n\n  try {\n    let transformer = sharp(filePath);\n    const metadata = await transformer.metadata();\n\n    if (options.resizeTo && metadata.width && metadata.height) {\n      const targetSize = options.resizeTo;\n      const scaleFactor =\n        targetSize / Math.min(metadata.width, metadata.height);\n      const newWidth = Math.round(metadata.width * scaleFactor);\n      const newHeight = Math.round(metadata.height * scaleFactor);\n      transformer = transformer.resize(newWidth, newHeight);\n    } else if (options.width || options.height) {\n      transformer = transformer.resize(\n        options.width || null,\n        options.height || null,\n        {\n          fit: \"inside\",\n        }\n      );\n    }\n\n    if (outputFormat === \"webp\") transformer = transformer.toFormat(\"webp\");\n    else if (outputFormat === \"jpeg\" || outputFormat === \"jpg\")\n      transformer = transformer.toFormat(\"jpeg\");\n\n    await transformer.toFile(tempPath);\n\n    await promisify(fs.rename)(tempPath, filePath);\n\n    return processFile(req, filePath);\n  } catch (error: any) {\n    try {\n      await promisify(fs.stat)(tempPath);\n      await promisify(fs.unlink)(tempPath);\n    } catch (err) {\n      // If temp file doesn't exist, no need to clean up\n    }\n\n    if (error.message === \"Input file contains unsupported image format\")\n      return processFile(req, filePath);\n    next(new AppError(error.message, 400, \"CannotProcessImage\", { error }));\n    return null;\n  }\n};\n"]}
+{"version":3,"file":"file-upload.helpers.js","sourceRoot":"","sources":["../../../../../../src/modules/file-upload/utils/helpers/file-upload.helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"fs\";\nimport path from \"path\";\nimport sharp from \"sharp\";\nimport { promisify } from \"util\";\nimport { getArkosConfig } from \"../../../../server\";\nimport mimetype from \"mimetype\";\nimport {\n  ArkosNextFunction,\n  ArkosRequest,\n  ArkosResponse,\n} from \"../../../../types\";\nimport { fullCleanCwd } from \"../../../../utils/helpers/fs.helpers\";\n\nexport function adjustRequestUrl(\n  req: ArkosRequest,\n  _: ArkosResponse,\n  next: ArkosNextFunction,\n) {\n  const { fileUpload } = getArkosConfig();\n  req.url = req.url.replace(\n    fileUpload?.baseRoute + \"/\" || \"/api/uploads/\",\n    \"/\",\n  );\n  req.url = req.url.replace(fileUpload?.baseRoute || \"/api/uploads/\", \"/\");\n  next();\n}\n\nexport function extractRequestInfo(req: ArkosRequest) {\n  const { fileUpload } = getArkosConfig();\n\n  // Determine the base URL for file access\n  const protocol =\n    req.secure || req.headers[\"x-forwarded-proto\"] === \"https\"\n      ? \"https\"\n      : \"http\";\n  const baseURL = `${protocol}://${req.get?.(\"host\")}`;\n  const baseRoute = fileUpload?.baseRoute || \"/api/uploads\";\n  return { baseURL, baseRoute };\n}\n\n/**\n * Generates the correct relative path regardless of upload directory location\n */\nexport function generateRelativePath(filePath: string, uploadDir: string) {\n  const { fileUpload } = getArkosConfig();\n\n  const baseUploadDir = fileUpload?.baseUploadDir || \"/uploads\";\n  if (baseUploadDir.startsWith(\"..\")) {\n    return path.join(uploadDir, path.basename(filePath));\n  } else {\n    return fullCleanCwd(filePath)\n      .replaceAll(\"\\\\\", \"/\")\n      .replace(`${baseUploadDir}/`, \"/\")\n      .replace(`/${baseUploadDir}/`, \"/\")\n      .replace(`/${baseUploadDir}`, \"\")\n      .replace(`${baseUploadDir}`, \"\")\n      .replaceAll(\"//\", \"/\");\n  }\n}\n\n/**\n * Handles basic file processing for non-image files\n */\nexport const processFile = (req: ArkosRequest, filePath: string): string => {\n  const { baseURL, baseRoute } = extractRequestInfo(req);\n\n  const relativePath = generateRelativePath(\n    filePath,\n    req.params!.fileType,\n  ).replace(/\\\\/g, \"/\");\n\n  return `${baseURL}${baseRoute === \"/\" ? \"\" : baseRoute}${\n    relativePath.startsWith(\"/\") ? relativePath : `/${relativePath}`\n  }`;\n};\n\n/**\n * Options accepted by the image optimizer. Numeric values may arrive as\n * strings from query parameters and are normalized internally.\n */\nexport interface ImageOptimizationOptions {\n  /** Set to `false` to skip optimization and keep the original bytes as-is. */\n  optimize?: boolean;\n  format?: string;\n  quality?: number | string;\n  width?: number | string;\n  height?: number | string;\n  resizeTo?: number | string;\n  fit?: \"cover\" | \"contain\" | \"fill\" | \"inside\" | \"outside\";\n  withoutEnlargement?: boolean;\n}\n\nconst SHARP_FORMATS = new Set([\n  \"jpeg\",\n  \"jpg\",\n  \"png\",\n  \"webp\",\n  \"avif\",\n  \"tiff\",\n  \"tif\",\n  \"gif\",\n  \"heif\",\n  \"heic\",\n]);\n\nconst QUALITY_FORMATS = new Set([\"jpeg\", \"webp\", \"avif\"]);\n\nconst toPositiveInt = (value?: number | string): number | undefined => {\n  if (value === undefined || value === null || value === \"\") return undefined;\n  const parsed = Number(value);\n  return Number.isFinite(parsed) && parsed > 0 ? Math.round(parsed) : undefined;\n};\n\nconst removeFile = async (target: string): Promise<void> => {\n  try {\n    await promisify(fs.unlink)(target);\n  } catch {}\n};\n\n/**\n * Optimizes an image file in place using Sharp. Returns the resulting file\n * path, which may use a different extension when a format is requested.\n */\nexport const optimizeImage = async (\n  filePath: string,\n  options: ImageOptimizationOptions = {},\n): Promise<string> => {\n  if (options.optimize === false) return filePath;\n\n  const ext = path.extname(filePath).toLowerCase();\n  const outputFormat = (options.format || \"webp\").toLowerCase();\n  const sharpFormat = outputFormat === \"jpg\" ? \"jpeg\" : outputFormat;\n\n  const directory = path.dirname(filePath);\n  const baseName = path.basename(filePath, ext);\n  const finalPath = path.join(directory, `${baseName}.${outputFormat}`);\n  const tempPath = path.join(\n    directory,\n    `${baseName}.${Date.now()}-${Math.round(Math.random() * 1e9)}.${outputFormat}`,\n  );\n\n  try {\n    const width = toPositiveInt(options.width);\n    const height = toPositiveInt(options.height);\n    const resizeTo = toPositiveInt(options.resizeTo);\n    const quality = toPositiveInt(options.quality);\n\n    let transformer = sharp(filePath).rotate();\n\n    if (resizeTo)\n      transformer = transformer.resize(resizeTo, resizeTo, {\n        fit: options.fit || \"inside\",\n        withoutEnlargement: options.withoutEnlargement ?? true,\n      });\n    else if (width || height)\n      transformer = transformer.resize(width || null, height || null, {\n        fit: options.fit || \"inside\",\n        ...(options.withoutEnlargement !== undefined && {\n          withoutEnlargement: options.withoutEnlargement,\n        }),\n      });\n\n    if (SHARP_FORMATS.has(sharpFormat)) {\n      const formatOptions =\n        quality && QUALITY_FORMATS.has(sharpFormat) ? { quality } : {};\n      transformer = transformer.toFormat(sharpFormat as any, formatOptions);\n    }\n\n    await transformer.toFile(tempPath);\n\n    await removeFile(filePath);\n    if (tempPath !== finalPath)\n      await promisify(fs.rename)(tempPath, finalPath);\n\n    return finalPath;\n  } catch (error) {\n    await removeFile(tempPath);\n    throw error;\n  }\n};\n\n/**\n * Processes image files using Sharp for resizing and format conversion\n */\nexport const processImage = async (\n  req: ArkosRequest,\n  next: ArkosNextFunction,\n  filePath: string,\n  options: ImageOptimizationOptions = {},\n): Promise<string | null> => {\n  const ext = path.extname(filePath).toLowerCase();\n\n  if (!mimetype.lookup(ext)?.includes?.(\"image\"))\n    return processFile(req, filePath);\n\n  try {\n    const optimizedPath = await optimizeImage(filePath, options);\n    return processFile(req, optimizedPath);\n  } catch (error: any) {\n    if (error.message === \"Input file contains unsupported image format\")\n      return processFile(req, filePath);\n    next(new Error(`Cannot process uploaded image: ${error.message}`));\n    return null;\n  }\n};\n\n"]}