feat: port linux server images to extension templates (#556)

Author: raghavyuva

api/api/versions.json

@@ -3,7 +3,7 @@
     {
       "version": "v1",
       "status": "active",
-      "release_date": "2025-11-02T07:52:11.101731+05:30",
+      "release_date": "2025-11-02T13:45:06.273828+05:30",
       "end_of_life": "0001-01-01T00:00:00Z",
       "changes": [
         "Initial API version"

api/doc/openapi.json

@@ -5,11 +5,10 @@ import (
 
 	"github.com/go-fuego/fuego"
 	"github.com/raghavyuva/nixopus-api/internal/features/logger"
+	"github.com/raghavyuva/nixopus-api/internal/types"
 )
 
-func (c *ExtensionsController) DeleteFork(ctx fuego.ContextNoBody) (*struct {
-	Status string `json:"status"`
-}, error) {
+func (c *ExtensionsController) DeleteFork(ctx fuego.ContextNoBody) (*types.Response, error) {
 	id := ctx.PathParam("id")
 	if id == "" {
 		return nil, fuego.HTTPError{Err: nil, Status: http.StatusBadRequest}
@@ -18,7 +17,5 @@ func (c *ExtensionsController) DeleteFork(ctx fuego.ContextNoBody) (*struct {
 		c.logger.Log(logger.Error, err.Error(), "")
 		return nil, fuego.HTTPError{Err: err, Status: http.StatusBadRequest}
 	}
-	return &struct {
-		Status string `json:"status"`
-	}{Status: "ok"}, nil
+	return &types.Response{Status: "success", Message: "Fork deleted successfully"}, nil
 }

api/internal/features/extension/controller/delete_extension.go

@@ -176,7 +176,8 @@ func (p *Parser) isValidCategory(category string) bool {
 	validCategories := []string{
 		"Security", "Containers", "Database", "Web Server",
 		"Maintenance", "Monitoring", "Storage", "Network",
-		"Development", "Other",
+		"Development", "Media", "Game", "Utility", "Productivity", "Other",
+		"Social",
 	}
 	for _, valid := range validCategories {
 		if category == valid {

api/internal/features/extension/parser/validate.go

@@ -20,7 +20,12 @@ const (
 	ExtensionCategoryStorage     ExtensionCategory = "Storage"
 	ExtensionCategoryNetwork     ExtensionCategory = "Network"
 	ExtensionCategoryDevelopment ExtensionCategory = "Development"
+	ExtensionCategoryMedia       ExtensionCategory = "Media"
+	ExtensionCategoryGame        ExtensionCategory = "Game"
+	ExtensionCategoryUtility     ExtensionCategory = "Utility"
 	ExtensionCategoryOther       ExtensionCategory = "Other"
+	ExtensionCategoryProductivity ExtensionCategory = "Productivity"
+	ExtensionCategorySocial       ExtensionCategory = "Social"
 )
 
 type ValidationStatus string

api/internal/types/extension.go

@@ -0,0 +1,5 @@
+ALTER TYPE extension_category ADD VALUE IF NOT EXISTS 'Media';
+ALTER TYPE extension_category ADD VALUE IF NOT EXISTS 'Game';
+ALTER TYPE extension_category ADD VALUE IF NOT EXISTS 'Utility';
+ALTER TYPE extension_category ADD VALUE IF NOT EXISTS 'Productivity';
+ALTER TYPE extension_category ADD VALUE IF NOT EXISTS 'Social';

api/migrations/extensions/041_add_media_category_down.sql

@@ -0,0 +1,7 @@
+ALTER TABLE extensions
+    DROP CONSTRAINT IF EXISTS extensions_description_check;
+
+ALTER TABLE extensions
+    ADD CONSTRAINT extensions_description_check 
+    CHECK (LENGTH(description) BETWEEN 10 AND 500);
+

api/migrations/extensions/041_add_media_category_up.sql

@@ -0,0 +1,7 @@
+ALTER TABLE extensions
+    DROP CONSTRAINT IF EXISTS extensions_description_check;
+
+ALTER TABLE extensions
+    ADD CONSTRAINT extensions_description_check 
+    CHECK (LENGTH(description) BETWEEN 10 AND 2000);
+

api/migrations/extensions/042_increase_description_length_down.sql

@@ -0,0 +1,128 @@
+metadata:
+  id: "deploy-adguardhome-sync"
+  name: "AdGuardHome Sync"
+  description: "AdGuardHome Sync is a tool to synchronize AdGuardHome config to replica instances. It allows you to keep multiple AdGuardHome instances in sync with a master configuration. uses adguardhome-sync image from linuxserver.io"
+  author: "Nixopus Team"
+  icon: "🔄"
+  category: "Network"
+  type: "install"
+  version: "1.0.0"
+  isVerified: false
+
+variables:
+  image:
+    type: "string"
+    description: "Docker image for AdGuardHome Sync"
+    default: "lscr.io/linuxserver/adguardhome-sync"
+    is_required: true
+
+  tag:
+    type: "string"
+    description: "Docker image tag"
+    default: "latest"
+    is_required: true
+
+  container_name:
+    type: "string"
+    description: "Name of the AdGuardHome Sync container"
+    default: "adguardhome-sync"
+    is_required: true
+
+  host_port:
+    type: "integer"
+    description: "Host port to expose AdGuardHome Sync web API"
+    default: 8080
+    is_required: true
+
+  container_port:
+    type: "integer"
+    description: "Container port for AdGuardHome Sync web API"
+    default: 8080
+    is_required: true
+
+  config_volume_name:
+    type: "string"
+    description: "Named Docker volume for AdGuardHome Sync configuration files"
+    default: "adguardhome-sync-config"
+    is_required: true
+
+  puid:
+    type: "integer"
+    description: "User ID for running the container"
+    default: 1000
+    is_required: false
+
+  pgid:
+    type: "integer"
+    description: "Group ID for running the container"
+    default: 1000
+    is_required: false
+
+  timezone:
+    type: "string"
+    description: "Timezone (TZ) environment variable"
+    default: "Etc/UTC"
+    is_required: false
+
+  config_file:
+    type: "string"
+    description: "Path to the config file inside the container"
+    default: "/config/adguardhome-sync.yaml"
+    is_required: false
+
+  proxy_domain:
+    type: "string"
+    description: "Domain name for AdGuardHome Sync (optional)"
+    default: ""
+    is_required: false
+
+execution:
+  run:
+    - name: "Remove existing AdGuardHome Sync container if present"
+      type: "docker"
+      properties:
+        action: "rm"
+        name: "{{ container_name }}"
+      timeout: 30
+
+    - name: "Pull AdGuardHome Sync image"
+      type: "docker"
+      properties:
+        action: "pull"
+        image: "{{ image }}"
+        tag: "{{ tag }}"
+      timeout: 300
+
+    - name: "Run AdGuardHome Sync container"
+      type: "docker"
+      properties:
+        action: "run"
+        name: "{{ container_name }}"
+        image: "{{ image }}"
+        tag: "{{ tag }}"
+        ports: "{{ host_port }}:{{ container_port }}"
+        volumes:
+          - "{{ config_volume_name }}:/config"
+        env:
+          PUID: "{{ puid }}"
+          PGID: "{{ pgid }}"
+          TZ: "{{ timezone }}"
+          CONFIGFILE: "{{ config_file }}"
+        restart: "unless-stopped"
+      timeout: 120
+
+    - name: "Add proxy for AdGuardHome Sync"
+      type: "proxy"
+      properties:
+        action: "add"
+        domain: "{{ proxy_domain }}"
+        port: "{{ host_port }}"
+      timeout: 30
+
+  # validate:
+  #   - name: "Check AdGuardHome Sync web API is accessible"
+  #     type: "command"
+  #     properties:
+  #       cmd: "sh -c 'for i in $(seq 1 30); do code=$(curl -fsS -o /dev/null -w \"%{http_code}\\n\" http://localhost:{{ host_port }} || true); echo \"HTTP $code\"; echo $code | grep -E \"^(200|301|302)$\" && exit 0; sleep 2; done; exit 1'"
+  #     timeout: 60
+