feat: sync master with latest changes

feat: Sync `master` with Latest Changes

Author: thatkazuk1

README.md

@@ -4,8 +4,9 @@
   "sourceRoot": "src",
   "compilerOptions": {
     "builder": "swc",
-    "deleteOutDir": false,
+    "deleteOutDir": true,
     "tsConfigPath": "tsconfig.build.json",
-    "typeCheck": false
+    "typeCheck": false,
+    "assets": ["**/*.yaml", "**/*.json"]
   }
 }

apps/api/nest-cli.json

@@ -7,10 +7,12 @@ import { TemplateModule } from './modules/templates/templates.module'
 import { UsersModule } from './modules/users/user.module'
 import { config } from '@/common/config'
 import { dbOptions } from '@/database/datasource'
+import { SeedersModule } from '@/database/seeders/seeders.module'
 
 @Module({
   imports: [
     ConfigModule.forRoot({ load: [() => config()] }),
+    SeedersModule,
     TypeOrmModule.forRoot({ ...dbOptions, autoLoadEntities: true }),
 
     AuthModule,

apps/api/src/app.module.ts

@@ -0,0 +1,11 @@
+import { Module } from '@nestjs/common'
+import { TypeOrmModule } from '@nestjs/typeorm'
+import { Config } from '@/modules/configs/configs.entity'
+import { ConfigTag } from '@/modules/configs/config-tag.entity'
+import { TemplatesSeederService } from './templates-seeder.service'
+
+@Module({
+  imports: [TypeOrmModule.forFeature([Config, ConfigTag])],
+  providers: [TemplatesSeederService],
+})
+export class SeedersModule {}

apps/api/src/database/seeders/seeders.module.ts

@@ -0,0 +1,137 @@
+import * as fs from 'node:fs'
+import * as path from 'node:path'
+import { Injectable, Logger, OnModuleInit } from '@nestjs/common'
+import { InjectRepository } from '@nestjs/typeorm'
+import { Repository } from 'typeorm'
+import { Config } from '@/modules/configs/configs.entity'
+import { ConfigTag } from '@/modules/configs/config-tag.entity'
+import { TemplateCategory } from '@/common/utils/enums'
+
+/**
+ * Sidecar JSON shape for a seeded template. The `description` field is kept
+ * in the source JSON for documentation and future-proofing, but is NOT
+ * persisted — the `Config` entity has no description column. Templates UI
+ * currently uses `title` only.
+ */
+interface TemplateMeta {
+  slug: string
+  title: string
+  description: string
+  category: TemplateCategory
+  tags: string[]
+}
+
+@Injectable()
+export class TemplatesSeederService implements OnModuleInit {
+  private readonly logger = new Logger(TemplatesSeederService.name)
+
+  constructor(
+    @InjectRepository(Config) private readonly configRepo: Repository<Config>,
+    @InjectRepository(ConfigTag) private readonly tagRepo: Repository<ConfigTag>,
+  ) {}
+
+  async onModuleInit(): Promise<void> {
+    const force = process.env.FORCE_TEMPLATE_RESEED === 'true'
+    let seedersDir = path.join(__dirname, 'templates')
+
+    if (!fs.existsSync(seedersDir)) {
+      const srcDir = path.join(__dirname, '../../../src/database/seeders/templates')
+      if (fs.existsSync(srcDir)) {
+        seedersDir = srcDir
+        this.logger.log(
+          'Templates seeder: Development mode detected, reading templates directly from src.',
+        )
+      } else {
+        this.logger.warn(
+          `Templates seeder: directory not found at ${seedersDir} or ${srcDir}; skipping.`,
+        )
+        return
+      }
+    }
+
+    const entries = fs.readdirSync(seedersDir)
+    const jsonFiles = entries.filter((f) => f.endsWith('.json')).sort()
+
+    let created = 0
+    let updated = 0
+    let skipped = 0
+    let failed = 0
+
+    for (const jsonFile of jsonFiles) {
+      try {
+        const result = await this.seedOne(seedersDir, jsonFile, force)
+        if (result === 'created') created++
+        else if (result === 'updated') updated++
+        else if (result === 'skipped') skipped++
+      } catch (err) {
+        failed++
+        this.logger.error(
+          `Templates seeder: failed to process ${jsonFile}: ${(err as Error).message}`,
+        )
+      }
+    }
+
+    this.logger.log(
+      `Templates seeder: created=${created}, updated=${updated}, skipped=${skipped}, failed=${failed} (force=${force})`,
+    )
+  }
+
+  private async seedOne(
+    seedersDir: string,
+    jsonFile: string,
+    force: boolean,
+  ): Promise<'created' | 'updated' | 'skipped'> {
+    const basename = jsonFile.replace(/\.json$/, '')
+    const yamlPath = path.join(seedersDir, `${basename}.yaml`)
+
+    if (!fs.existsSync(yamlPath)) {
+      this.logger.warn(`Template metadata ${jsonFile} has no matching YAML; skipping.`)
+      return 'skipped'
+    }
+
+    const meta: TemplateMeta = JSON.parse(fs.readFileSync(path.join(seedersDir, jsonFile), 'utf8'))
+    const yaml = fs.readFileSync(yamlPath, 'utf8')
+
+    const existing = await this.configRepo.findOne({
+      where: { slug: meta.slug },
+      relations: ['tags'],
+    })
+
+    if (existing) {
+      if (!force) return 'skipped'
+
+      existing.title = meta.title
+      existing.yaml = yaml
+      existing.templateCategory = meta.category
+      existing.isTemplate = true
+      await this.configRepo.save(existing)
+
+      await this.tagRepo.delete({ configId: existing.id })
+      if (meta.tags.length > 0) {
+        const tagEntities = meta.tags.map((tag) =>
+          this.tagRepo.create({ configId: existing.id, tag }),
+        )
+        await this.tagRepo.save(tagEntities)
+      }
+
+      return 'updated'
+    }
+
+    const fresh = this.configRepo.create({
+      slug: meta.slug,
+      title: meta.title,
+      yaml,
+      isTemplate: true,
+      templateCategory: meta.category,
+      userId: null,
+    })
+    const saved = await this.configRepo.save(fresh)
+
+    if (meta.tags.length > 0) {
+      const tagEntities = meta.tags.map((tag) => this.tagRepo.create({ configId: saved.id, tag }))
+      await this.tagRepo.save(tagEntities)
+    }
+
+    return 'created'
+  }
+}

apps/api/src/database/seeders/templates-seeder.service.ts

@@ -0,0 +1,7 @@
+{
+  "slug": "single-host-docker",
+  "title": "Single-Host Docker",
+  "description": "Mini-PC running Portainer, Pi-hole, Jellyfin, and Nextcloud in Docker, connected to a 5-port consumer router.",
+  "category": "virtualization",
+  "tags": ["DOCKER", "SINGLE HOST", "BEGINNER"]
+}

apps/api/src/database/seeders/templates/01-single-host-docker.json

@@ -0,0 +1,79 @@
+meta:
+  title: Single-Host Docker
+  subtitle: One mini-PC running a small service stack
+  tags:
+    - DOCKER
+    - SINGLE HOST
+    - BEGINNER
+
+networks:
+  - id: lan
+    name: Home LAN
+    subnet: 192.168.1.0/24
+
+groups:
+  - id: edge
+    name: Network Edge
+    style: dashed
+    color: "#00e5ff"
+  - id: host
+    name: Docker Host
+    style: solid
+    color: "#ffab00"
+
+devices:
+  - id: router
+    name: Home Router
+    type: router
+    ip: 192.168.1.1
+    network: lan
+    group: edge
+    interfaces:
+      ethernet:
+        count: 5
+        speed: 1G
+        ports:
+          - { label: WAN }
+          - { label: LAN1 }
+          - { label: LAN2 }
+          - { label: LAN3 }
+          - { label: LAN4 }
+
+  - id: docker-host
+    name: docker-host
+    type: server
+    ip: 192.168.1.10
+    network: lan
+    group: host
+    specs:
+      cpu: Intel N100
+      ram: 16 GB
+      storage: 1 TB NVMe
+      os: Debian 12
+    interfaces:
+      ethernet:
+        count: 1
+        speed: 2.5G
+    services:
+      - name: Portainer
+        port: 9000
+        runtime: docker
+      - name: Pi-hole
+        port: 80
+        runtime: docker
+      - name: Jellyfin
+        port: 8096
+        runtime: docker
+      - name: Nextcloud
+        port: 8080
+        runtime: docker
+      - name: Uptime Kuma
+        port: 3001
+        runtime: docker
+
+connections:
+  - from: router
+    to: docker-host
+    fromPort: LAN1
+    type: ethernet
+    speed: 2.5G

apps/api/src/database/seeders/templates/01-single-host-docker.yaml

@@ -0,0 +1,7 @@
+{
+  "slug": "proxmox-cluster",
+  "title": "Proxmox 3-Node Cluster",
+  "description": "Three Proxmox nodes (EPYC, 128 GB RAM each) with bonded 10G uplinks to a core switch, plus Ceph storage for HA.",
+  "category": "virtualization",
+  "tags": ["PROXMOX", "CLUSTER", "CEPH"]
+}