feat: [PPT-2172] Add endpoint to retrieve repo folder tree (#411)

Author: naqvis

OPENAPI_DOC.yml

@@ -12322,6 +12322,83 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/PlaceOS__Api__Application__ContentError'
+  /api/engine/v2/repositories/{id}/folders:
+    get:
+      summary: lists the folders tree in a repository
+      tags:
+      - Repositories
+      operationId: PlaceOS::Api::Repositories_folders
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include_dots
+        in: query
+        description: include dots folders, default to false
+        example: "true"
+        schema:
+          type: boolean
+      responses:
+        200:
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/String'
+        409:
+          description: Conflict
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PlaceOS__Api__Application__CommonError'
+        401:
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PlaceOS__Api__Application__CommonError'
+        403:
+          description: Forbidden
+        404:
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PlaceOS__Api__Application__CommonError'
+        408:
+          description: Request Timeout
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PlaceOS__Api__Application__CommonError'
+        400:
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PlaceOS__Api__Application__ParameterError'
+        422:
+          description: Unprocessable Entity
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PlaceOS__Api__Application__ParameterError'
+        406:
+          description: Not Acceptable
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PlaceOS__Api__Application__ContentError'
+        415:
+          description: Unsupported Media Type
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PlaceOS__Api__Application__ContentError'
   /api/engine/v2/repositories/{id}/commits:
     get:
       summary: Returns the commits for a repository or file
@@ -25156,6 +25233,9 @@ components:
           - driver
           - interface
           nullable: true
+        root_path:
+          type: string
+          nullable: true
         has_runtime_error:
           type: boolean
           nullable: true

shard.lock

@@ -95,7 +95,7 @@ shards:
 
   git-repository:
     git: https://github.com/place-labs/git-repository.git
-    version: 1.5.0
+    version: 1.6.0
 
   google:
     git: https://github.com/placeos/google.git
@@ -207,15 +207,15 @@ shards:
 
   placeos-frontend-loader:
     git: https://github.com/placeos/frontend-loader.git
-    version: 2.7.1+git.commit.ed25c13e04403056f050998de9fd84eed530a24f
+    version: 2.7.1+git.commit.0db3a335971e9837fa45eaecfa4877f7a1814a1b
 
   placeos-log-backend:
     git: https://github.com/place-labs/log-backend.git
     version: 0.13.0
 
   placeos-models:
     git: https://github.com/placeos/models.git
-    version: 9.72.4
+    version: 9.73.0
 
   placeos-resource:
     git: https://github.com/place-labs/resource.git

src/placeos-rest-api/controllers/repositories.cr

@@ -125,6 +125,18 @@ module PlaceOS::Api
       end
     end
 
+    # lists the folders tree in a repository
+    @[AC::Route::GET("/:id/folders")]
+    def folders(
+      @[AC::Param::Info(description: "include dots folders, default to false", example: "true")]
+      include_dots : Bool = false,
+    ) : Array(String)
+      FrontendLoader::Client.client(request_id: request_id) do |frontends_client|
+        password = current_repo.decrypt_password if current_repo.password.presence
+        frontends_client.folders(current_repo.uri, current_repo.branch, current_repo.username, password, include_dots)
+      end
+    end
+
     # Returns the commits for a repository or file
     @[AC::Route::GET("/:id/commits")]
     def commits(