add test e2e for import endpoint

Author: mirkoCrobu

cmd/gendoc/docs.go

@@ -562,6 +562,31 @@ Contains a JSON object with the details of an error.
 				{StatusCode: http.StatusInternalServerError, Reference: "#/components/responses/InternalServerError"},
 			},
 		},
+		{
+			OperationId: "importApp",
+			Method:      http.MethodPost,
+			Path:        "/v1/apps/import",
+			Parameters:  nil,
+			Request: (*struct {
+				File []byte `form:"file" description:"The ZIP archive containing the application structure. Must contain app.yaml. and python folder" validate:"required"`
+			})(nil),
+			CustomSuccessResponse: &CustomResponseDef{
+				ContentType: "application/json",
+				StatusCode:  http.StatusCreated,
+				DataStructure: struct {
+					ID string `json:"id" description:"The Base64 encoded identifier of the imported application."`
+				}{},
+				Description: "Application imported successfully.",
+			},
+			Description: "Imports a new application from a ZIP file. The system extracts the archive, validates the app.yaml manifest, sanitizes the name, and returns the ID in Base64.",
+			Summary:     "Imports an app from ZIP",
+			Tags:        []Tag{ApplicationTag},
+			PossibleErrors: []ErrorResponse{
+				{StatusCode: http.StatusBadRequest, Reference: "#/components/responses/BadRequest"},
+				{StatusCode: http.StatusConflict, Reference: "#/components/responses/Conflict"},
+				{StatusCode: http.StatusInternalServerError, Reference: "#/components/responses/InternalServerError"},
+			},
+		},
 		{
 			OperationId: "exportApp",
 			Method:      http.MethodGet,

internal/api/docs/openapi.yaml

@@ -710,6 +710,53 @@ paths:
       summary: Get application events
       tags:
       - Application
+  /v1/apps/import:
+    post:
+      description: Imports a new application from a ZIP file. The system extracts
+        the archive, validates the app.yaml manifest, sanitizes the name, and returns
+        the ID in Base64.
+      operationId: importApp
+      parameters:
+      - description: The ZIP archive containing the application structure. Must contain
+          app.yaml. and python folder
+        in: query
+        name: file
+        schema:
+          description: The ZIP archive containing the application structure. Must
+            contain app.yaml. and python folder
+          format: base64
+          type: string
+      requestBody:
+        content:
+          application/x-www-form-urlencoded:
+            schema:
+              properties:
+                file:
+                  description: The ZIP archive containing the application structure.
+                    Must contain app.yaml. and python folder
+                  format: base64
+                  type: string
+              type: object
+      responses:
+        "201":
+          content:
+            application/json:
+              schema:
+                properties:
+                  id:
+                    description: The Base64 encoded identifier of the imported application.
+                    type: string
+                type: object
+          description: Application imported successfully.
+        "400":
+          $ref: '#/components/responses/BadRequest'
+        "409":
+          $ref: '#/components/responses/Conflict'
+        "500":
+          $ref: '#/components/responses/InternalServerError'
+      summary: Imports an app from ZIP
+      tags:
+      - Application
   /v1/bricks:
     get:
       description: Returns all the existing bricks. Bricks that are ready to use are