feat: Create API for new storage folder (#168)

* First version, wip

* feat(#1989): create api for new Swarm storage folder.
- add: conforms to OCS OpenAPI standard
- add: add composer packages for OCS extractor

* feat(#1989): create api for new Swarm storage folder.
- reverse previous commit

* feat(#1989): create api for new Swarm storage folder.
 - reverse previous commit

* feat(#1989): create api for new Swarm storage folder.
    - reverse previous commit

* chore: precommit setup and lint fixes

* feat(#1989): add ConfigurationController for storage creation
- add: new ConfigurationController with create endpoint with redirect to NC URL.
- add: corresponding route in routes.php

* chore(#1989): Run php-cs-fixer on committed files

* refactor: use const for the key on key

* chore: code style

* feat: reuse URL validation

* chore: code style

* feat: error and creation handling

* feat: lint-stage and precommit rules

* fix: lint ci

* chore: apply automated formatting

---------

Co-authored-by: Ron Trevor <ecoron@proton.me>
Co-authored-by: Mahyar Iranibazaz <mahiarirani@pm.me>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: 4 people

.github/workflows/lint.yml

@@ -1,5 +1,8 @@
 name: Lint
 
+permissions:
+  contents: write
+
 on:
   pull_request:
     branches:
@@ -10,16 +13,16 @@ on:
       - reopened
 
 jobs:
-  backend-lint:
-    name: Backend Lint
+  format-sync:
+    name: Format Sync
     runs-on: ubuntu-latest
 
-    strategy:
-      fail-fast: true
-
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
+        with:
+          ref: ${{ github.head_ref }}
+          fetch-depth: 0
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
@@ -28,18 +31,48 @@ jobs:
           tools: composer
 
       - name: Install php-cs-fixer
-        run: composer require --dev friendsofphp/php-cs-fixer
+        run: composer require --dev friendsofphp/php-cs-fixer nextcloud/coding-standard --no-interaction --no-progress --no-scripts
+
+      - name: Apply php-cs-fixer
+        run: vendor/bin/php-cs-fixer fix
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.28.2
+          run_install: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+          cache: "pnpm"
 
-      - name: Run php-cs-fixer
-        run: vendor/bin/php-cs-fixer fix --dry-run --diff
+      - name: Install JS dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Apply Biome format
+        run: pnpm run format:fix
+
+      - name: Commit format changes
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "chore: apply automated formatting"
+          commit_user_name: "github-actions[bot]"
+          commit_user_email: "github-actions[bot]@users.noreply.github.com"
+          commit_author: "github-actions[bot] <github-actions[bot]@users.noreply.github.com>"
 
   frontend-lint:
     name: Frontend Lint
     runs-on: ubuntu-latest
+    needs: format-sync
 
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
+        with:
+          ref: ${{ github.head_ref }}
+          fetch-depth: 0
 
       - name: Setup pnpm
         uses: pnpm/action-setup@v4
@@ -59,8 +92,5 @@ jobs:
       - name: Run Biome lint
         run: pnpm run lint
 
-      - name: Run Biome format check
-        run: pnpm run format
-
       - name: Run TypeScript type check
         run: pnpm run typecheck

appinfo/routes.php

@@ -33,5 +33,17 @@
 			'url' => '/feedback/submit',
 			'verb' => 'POST',
 		],
+		[
+			'name' => 'Configuration#create',
+			'url' => 'configure/create',
+			'verb' => 'GET',
+		],
+	],
+	'ocs' => [
+		[
+			'name' => 'Storage#create',
+			'url' => '/api/v1/storages',
+			'verb' => 'POST',
+		],
 	],
 ];

composer.json

@@ -8,13 +8,15 @@
 		}
 	},
 	"require": {
-		"ext-curl": "*"
+		"ext-curl": "*",
+		"ext-simplexml": "*"
 	},
 	"require-dev": {
-		"nextcloud/coding-standard": "^1.3.2",
+		"nextcloud/coding-standard": "^1.4",
 		"ext-fileinfo": "*",
 		"friendsofphp/php-cs-fixer": "*",
-		"bamarni/composer-bin-plugin": "^1.8"
+		"bamarni/composer-bin-plugin": "^1.8",
+		"vimeo/psalm": "*"
 	},
 	"scripts": {
 		"cs:check": "./vendor/php-cs-fixer/shim/php-cs-fixer.phar fix --dry-run --diff",