@underundre/undev 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Undre
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,148 @@
+# @underundre/undev
+
+Reusable dev scripts, configs, and templates for Node.js/TypeScript projects.
+
+[Русская версия](README.ru.md)
+
+## What's Inside
+
+```
+configs/                    # Shareable tool configs
+  eslint.config.js          #   ESLint flat config (TS strict)
+  prettier.config.js        #   Prettier rules
+  tsconfig.base.json        #   TypeScript strict base
+  commitlint.config.js      #   Conventional Commits
+  .editorconfig             #   IDE settings
+
+scripts/                    # Bash scripts (parameterized via env vars)
+  common.sh                 #   Shared utils (colors, logging, confirm, telegram)
+  deploy/
+    deploy.sh               #   Zero-downtime SSH deploy
+    rollback.sh             #   Rollback to previous deploy
+    logs.sh                 #   Tail prod logs (pm2/docker/nginx)
+  db/
+    backup.sh               #   PostgreSQL backup with retention
+    restore.sh              #   PostgreSQL restore from dump
+  server/
+    setup-vps.sh            #   Fresh VPS bootstrap (user, ssh, ufw, node, pm2)
+    setup-ssl.sh            #   Let's Encrypt + auto-renewal
+    health-check.sh         #   Disk/memory/CPU/services check
+  docker/
+    cleanup.sh              #   Prune images, containers, volumes
+  dev/
+    setup.sh                #   Clone → install → .env → migrate → build
+  monitoring/
+    security-audit.sh       #   npm audit + secret scan + outdated deps
+
+templates/                  # Copy into your project
+  .github/workflows/ci.yml #   GitHub Actions CI pipeline
+  .env.example              #   Environment variables template
+  docker-compose.dev.yml    #   Dev DB (Postgres + Redis)
+  package-scripts.jsonc     #   Recommended npm scripts reference
+```
+
+## Usage: Configs
+
+Install as dev dependency:
+
+```bash
+npm i -D @underundre/undev
+```
+
+### ESLint
+
+```js
+// eslint.config.js
+import baseConfig from "@underundre/undev/eslint";
+export default [...baseConfig];
+```
+
+### TypeScript
+
+```json
+// tsconfig.json
+{
+  "extends": "@underundre/undev/tsconfig",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"]
+}
+```
+
+### Prettier
+
+```json
+// package.json
+{ "prettier": "@underundre/undev/prettier" }
+```
+
+### Commitlint
+
+```js
+// commitlint.config.js
+export default { extends: ["@underundre/undev/commitlint"] };
+```
+
+## Usage: Scripts
+
+Copy the scripts you need into your project:
+
+```bash
+# Copy deploy scripts
+cp -r node_modules/@underundre/undev/scripts/deploy ./scripts/deploy
+cp node_modules/@underundre/undev/scripts/common.sh ./scripts/
+
+# Or cherry-pick
+cp node_modules/@underundre/undev/scripts/db/backup.sh ./scripts/
+```
+
+All scripts read config from environment variables. Set them in `.env.production` or pass inline:
+
+```bash
+PROD_SSH_HOST=deploy@myserver.com REMOTE_APP_DIR=/home/deploy/app ./scripts/deploy/deploy.sh
+```
+
+### Script Config Reference
+
+| Variable | Used by | Default |
+|----------|---------|---------|
+| `PROD_SSH_HOST` | deploy, rollback, logs | required |
+| `REMOTE_APP_DIR` | deploy, rollback | required |
+| `POSTGRES_HOST` | db/backup, db/restore | `localhost` |
+| `POSTGRES_PORT` | db/backup, db/restore | `5432` |
+| `POSTGRES_USER` | db/backup, db/restore | `postgres` |
+| `POSTGRES_DB` | db/backup, db/restore | required |
+| `BACKUP_DIR` | db/backup | `./backups` |
+| `RETENTION_DAYS` | db/backup | `14` |
+| `TELEGRAM_BOT_TOKEN` | all (optional notifications) | — |
+| `TELEGRAM_CHAT_ID` | all (optional notifications) | — |
+
+## Usage: Templates
+
+```bash
+# CI workflow
+cp node_modules/@underundre/undev/templates/.github/workflows/ci.yml .github/workflows/
+
+# Environment template
+cp node_modules/@underundre/undev/templates/.env.example .
+
+# Dev Docker Compose
+cp node_modules/@underundre/undev/templates/docker-compose.dev.yml .
+```
+
+## npm Scripts Reference
+
+See `templates/package-scripts.jsonc` for a complete set of recommended scripts. Key ones:
+
+```json
+{
+  "validate": "npm run lint && npm run typecheck && npm run format:check",
+  "validate:fix": "npm run lint:fix && npm run typecheck && npm run format"
+}
+```
+
+## License
+
+MIT

package/README.ru.md

@@ -0,0 +1,148 @@
+# @underundre/undev
+
+Переиспользуемые dev-скрипты, конфиги и шаблоны для Node.js/TypeScript проектов.
+
+[English version](README.md)
+
+## Что внутри
+
+```
+configs/                    # Шарируемые конфиги инструментов
+  eslint.config.js          #   ESLint flat config (строгий TS)
+  prettier.config.js        #   Prettier правила
+  tsconfig.base.json        #   TypeScript strict база
+  commitlint.config.js      #   Conventional Commits
+  .editorconfig             #   Настройки IDE
+
+scripts/                    # Bash-скрипты (параметризованы через env vars)
+  common.sh                 #   Общие утилиты (цвета, логирование, confirm, telegram)
+  deploy/
+    deploy.sh               #   Zero-downtime SSH деплой
+    rollback.sh             #   Откат на предыдущий деплой
+    logs.sh                 #   Tail логов на проде (pm2/docker/nginx)
+  db/
+    backup.sh               #   Бэкап PostgreSQL с ротацией
+    restore.sh              #   Восстановление PostgreSQL из дампа
+  server/
+    setup-vps.sh            #   Настройка свежего VPS (юзер, ssh, ufw, node, pm2)
+    setup-ssl.sh            #   Let's Encrypt + автообновление
+    health-check.sh         #   Проверка диска/памяти/CPU/сервисов
+  docker/
+    cleanup.sh              #   Очистка images, containers, volumes
+  dev/
+    setup.sh                #   Клон → установка → .env → миграции → билд
+  monitoring/
+    security-audit.sh       #   npm audit + сканирование секретов + устаревшие зависимости
+
+templates/                  # Скопировать в свой проект
+  .github/workflows/ci.yml #   GitHub Actions CI пайплайн
+  .env.example              #   Шаблон переменных окружения
+  docker-compose.dev.yml    #   Dev БД (Postgres + Redis)
+  package-scripts.jsonc     #   Рекомендуемые npm scripts
+```
+
+## Использование: Конфиги
+
+Установить как dev-зависимость:
+
+```bash
+npm i -D @underundre/undev
+```
+
+### ESLint
+
+```js
+// eslint.config.js
+import baseConfig from "@underundre/undev/eslint";
+export default [...baseConfig];
+```
+
+### TypeScript
+
+```json
+// tsconfig.json
+{
+  "extends": "@underundre/undev/tsconfig",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"]
+}
+```
+
+### Prettier
+
+```json
+// package.json
+{ "prettier": "@underundre/undev/prettier" }
+```
+
+### Commitlint
+
+```js
+// commitlint.config.js
+export default { extends: ["@underundre/undev/commitlint"] };
+```
+
+## Использование: Скрипты
+
+Скопировать нужные скрипты в проект:
+
+```bash
+# Скопировать скрипты деплоя
+cp -r node_modules/@underundre/undev/scripts/deploy ./scripts/deploy
+cp node_modules/@underundre/undev/scripts/common.sh ./scripts/
+
+# Или по одному
+cp node_modules/@underundre/undev/scripts/db/backup.sh ./scripts/
+```
+
+Все скрипты читают конфиг из переменных окружения. Задать в `.env.production` или передать инлайн:
+
+```bash
+PROD_SSH_HOST=deploy@myserver.com REMOTE_APP_DIR=/home/deploy/app ./scripts/deploy/deploy.sh
+```
+
+### Переменные окружения
+
+| Переменная | Используется | По умолчанию |
+|-----------|-------------|-------------|
+| `PROD_SSH_HOST` | deploy, rollback, logs | обязательно |
+| `REMOTE_APP_DIR` | deploy, rollback | обязательно |
+| `POSTGRES_HOST` | db/backup, db/restore | `localhost` |
+| `POSTGRES_PORT` | db/backup, db/restore | `5432` |
+| `POSTGRES_USER` | db/backup, db/restore | `postgres` |
+| `POSTGRES_DB` | db/backup, db/restore | обязательно |
+| `BACKUP_DIR` | db/backup | `./backups` |
+| `RETENTION_DAYS` | db/backup | `14` |
+| `TELEGRAM_BOT_TOKEN` | все (опц. уведомления) | — |
+| `TELEGRAM_CHAT_ID` | все (опц. уведомления) | — |
+
+## Использование: Шаблоны
+
+```bash
+# CI workflow
+cp node_modules/@underundre/undev/templates/.github/workflows/ci.yml .github/workflows/
+
+# Шаблон окружения
+cp node_modules/@underundre/undev/templates/.env.example .
+
+# Dev Docker Compose
+cp node_modules/@underundre/undev/templates/docker-compose.dev.yml .
+```
+
+## npm Scripts
+
+См. `templates/package-scripts.jsonc`. Ключевые:
+
+```json
+{
+  "validate": "npm run lint && npm run typecheck && npm run format:check",
+  "validate:fix": "npm run lint:fix && npm run typecheck && npm run format"
+}
+```
+
+## Лицензия
+
+MIT

package/configs/.editorconfig

@@ -0,0 +1,28 @@
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab
+
+[*.{sh,bash}]
+indent_size = 2
+end_of_line = lf
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[*.{json,jsonc}]
+indent_size = 2
+
+[*.{sql}]
+indent_size = 4

package/configs/commitlint.config.js

@@ -0,0 +1,36 @@
+/**
+ * Shareable commitlint config — Conventional Commits.
+ *
+ * Usage in your project:
+ *   export default { extends: ["@underundre/undev/commitlint"] };
+ *
+ * Or import directly:
+ *   import config from "@underundre/undev/commitlint";
+ *   export default config;
+ */
+
+export default {
+  extends: ["@commitlint/config-conventional"],
+  rules: {
+    "type-enum": [
+      2,
+      "always",
+      [
+        "feat",
+        "fix",
+        "docs",
+        "style",
+        "refactor",
+        "perf",
+        "test",
+        "build",
+        "ci",
+        "chore",
+        "revert",
+      ],
+    ],
+    "subject-case": [2, "never", ["start-case", "pascal-case", "upper-case"]],
+    "subject-max-length": [2, "always", 100],
+    "body-max-line-length": [1, "always", 100],
+  },
+};

package/configs/eslint.config.js

@@ -0,0 +1,58 @@
+/**
+ * Shareable ESLint flat config for TypeScript projects.
+ *
+ * Usage in your project:
+ *   import baseConfig from "@underundre/undev/eslint";
+ *   export default [...baseConfig, { /* your overrides * / }];
+ */
+
+import js from "@eslint/js";
+import tsPlugin from "@typescript-eslint/eslint-plugin";
+import tsParser from "@typescript-eslint/parser";
+
+/** @type {import("eslint").Linter.Config[]} */
+export default [
+  js.configs.recommended,
+  {
+    files: ["**/*.ts", "**/*.tsx", "**/*.mts"],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        projectService: true,
+      },
+    },
+    plugins: {
+      "@typescript-eslint": tsPlugin,
+    },
+    rules: {
+      // TypeScript strict
+      "@typescript-eslint/no-explicit-any": "error",
+      "@typescript-eslint/no-unused-vars": ["error", { argsIgnorePattern: "^_" }],
+      "@typescript-eslint/consistent-type-imports": ["error", { prefer: "type-imports" }],
+      "@typescript-eslint/no-import-type-side-effects": "error",
+
+      // Safety
+      "no-console": ["warn", { allow: ["warn", "error"] }],
+      "no-debugger": "error",
+      "no-eval": "error",
+      "no-implied-eval": "error",
+      "prefer-const": "error",
+      "no-var": "error",
+      eqeqeq: ["error", "always"],
+
+      // Style (let prettier handle formatting)
+      "no-multiple-empty-lines": ["error", { max: 1 }],
+    },
+  },
+  {
+    ignores: [
+      "node_modules/",
+      "dist/",
+      "build/",
+      "coverage/",
+      "*.min.js",
+      ".next/",
+      ".nuxt/",
+    ],
+  },
+];

package/configs/prettier.config.js

@@ -0,0 +1,23 @@
+/**
+ * Shareable Prettier config.
+ *
+ * Usage in your project's package.json:
+ *   "prettier": "@underundre/undev/prettier"
+ *
+ * Or in prettier.config.js:
+ *   import config from "@underundre/undev/prettier";
+ *   export default { ...config, /* overrides */ };
+ */
+
+/** @type {import("prettier").Config} */
+export default {
+  semi: true,
+  singleQuote: false,
+  tabWidth: 2,
+  trailingComma: "all",
+  printWidth: 100,
+  bracketSpacing: true,
+  arrowParens: "always",
+  endOfLine: "lf",
+  plugins: [],
+};

package/configs/tsconfig.base.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "noUncheckedIndexedAccess": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "verbatimModuleSyntax": true
+  }
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@underundre/undev",
+  "version": "0.1.0",
+  "description": "Reusable dev scripts, configs, and templates for Node.js/TypeScript projects",
+  "type": "module",
+  "exports": {
+    "./eslint": "./configs/eslint.config.js",
+    "./prettier": "./configs/prettier.config.js",
+    "./tsconfig": "./configs/tsconfig.base.json",
+    "./commitlint": "./configs/commitlint.config.js"
+  },
+  "files": [
+    "configs",
+    "scripts",
+    "templates"
+  ],
+  "scripts": {
+    "lint": "echo 'No source to lint'",
+    "test": "echo 'No tests yet'"
+  },
+  "keywords": [
+    "dev-scripts",
+    "configs",
+    "eslint",
+    "prettier",
+    "typescript",
+    "deploy",
+    "devops"
+  ],
+  "author": "UnderUndre",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/UnderUndre/undev.git"
+  },
+  "bugs": {
+    "url": "https://github.com/UnderUndre/undev/issues"
+  },
+  "homepage": "https://github.com/UnderUndre/undev#readme",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "peerDependencies": {
+    "eslint": ">=9.0.0",
+    "prettier": ">=3.0.0",
+    "typescript": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "eslint": { "optional": true },
+    "prettier": { "optional": true },
+    "typescript": { "optional": true }
+  }
+}

package/scripts/common.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+# ─────────────────────────────────────────────────
+# Common utilities for all undev scripts.
+# Source this at the top of every script:
+#   source "$(dirname "$0")/common.sh"
+# ─────────────────────────────────────────────────
+
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Detect repo root
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(git -C "$SCRIPT_DIR" rev-parse --show-toplevel 2>/dev/null || dirname "$SCRIPT_DIR")"
+
+# Logging
+log()   { echo -e "${GREEN}[$(date '+%H:%M:%S')]${NC} $1"; }
+warn()  { echo -e "${YELLOW}[$(date '+%H:%M:%S')] WARN:${NC} $1"; }
+error() { echo -e "${RED}[$(date '+%H:%M:%S')] ERROR:${NC} $1" >&2; }
+info()  { echo -e "${CYAN}[$(date '+%H:%M:%S')]${NC} $1"; }
+step()  { echo -e "${BLUE}▸${NC} $1"; }
+
+# Confirm prompt (skip if --yes or CI)
+confirm() {
+    local msg="${1:-Continue?}"
+    if [[ "${YES:-false}" == "true" ]] || [[ "${CI:-false}" == "true" ]]; then
+        return 0
+    fi
+    read -rp "$(echo -e "${YELLOW}${msg} [y/N]${NC} ")" answer
+    [[ "$answer" =~ ^[Yy]$ ]]
+}
+
+# Load .env file if it exists
+load_env() {
+    local env_file="${1:-.env}"
+    if [[ -f "$REPO_ROOT/$env_file" ]]; then
+        set -a
+        source "$REPO_ROOT/$env_file"
+        set +a
+    fi
+}
+
+# Telegram notification (optional — needs TELEGRAM_BOT_TOKEN + TELEGRAM_CHAT_ID)
+notify_telegram() {
+    local message="$1"
+    if [[ -n "${TELEGRAM_BOT_TOKEN:-}" ]] && [[ -n "${TELEGRAM_CHAT_ID:-}" ]]; then
+        curl -sf -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
+            --data-urlencode "chat_id=${TELEGRAM_CHAT_ID}" \
+            --data-urlencode "text=${message}" \
+            --data-urlencode "parse_mode=Markdown" > /dev/null 2>&1 &
+    fi
+}
+
+# Git helpers
+git_branch()  { git -C "$REPO_ROOT" rev-parse --abbrev-ref HEAD; }
+git_commit()  { git -C "$REPO_ROOT" rev-parse --short HEAD; }
+git_version() { node -p "require('$REPO_ROOT/package.json').version" 2>/dev/null || echo "0.0.0"; }
+git_dirty()   { [[ -n "$(git -C "$REPO_ROOT" status --porcelain)" ]]; }
+
+# Require commands
+require_cmd() {
+    for cmd in "$@"; do
+        if ! command -v "$cmd" &>/dev/null; then
+            error "Required command not found: $cmd"
+            exit 1
+        fi
+    done
+}

package/scripts/db/backup.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+# ─────────────────────────────────────────────────
+# PostgreSQL database backup.
+#
+# Config (env vars or .env):
+#   POSTGRES_HOST     (default: localhost)
+#   POSTGRES_PORT     (default: 5432)
+#   POSTGRES_USER     (default: postgres)
+#   POSTGRES_DB       (required)
+#   BACKUP_DIR        (default: ./backups)
+#   RETENTION_DAYS    (default: 14)
+#
+# Usage:
+#   ./scripts/db/backup.sh              # Backup to local dir
+#   BACKUP_DIR=/mnt/s3 ./scripts/db/backup.sh  # Custom dir
+# ─────────────────────────────────────────────────
+
+source "$(dirname "$0")/../common.sh"
+load_env
+
+require_cmd pg_dump
+
+: "${POSTGRES_DB:?Set POSTGRES_DB}"
+
+DB_HOST="${POSTGRES_HOST:-localhost}"
+DB_PORT="${POSTGRES_PORT:-5432}"
+DB_USER="${POSTGRES_USER:-postgres}"
+BACKUP_DIR="${BACKUP_DIR:-$REPO_ROOT/backups}"
+RETENTION_DAYS="${RETENTION_DAYS:-14}"
+
+DATE=$(date +%Y%m%d_%H%M%S)
+BACKUP_FILE="${BACKUP_DIR}/${POSTGRES_DB}_${DATE}.dump"
+
+mkdir -p "$BACKUP_DIR"
+
+step "Backing up ${POSTGRES_DB}@${DB_HOST}:${DB_PORT}..."
+pg_dump -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -Fc "$POSTGRES_DB" > "$BACKUP_FILE"
+
+SIZE=$(du -h "$BACKUP_FILE" | cut -f1)
+log "Backup complete: $BACKUP_FILE ($SIZE)"
+
+# Retention cleanup
+if [[ "$RETENTION_DAYS" -gt 0 ]]; then
+    DELETED=$(find "$BACKUP_DIR" -name "*.dump" -mtime "+$RETENTION_DAYS" -delete -print | wc -l)
+    if [[ "$DELETED" -gt 0 ]]; then
+        info "Cleaned $DELETED old backups (>$RETENTION_DAYS days)"
+    fi
+fi
+
+notify_telegram "💾 *DB Backup*
+📦 $POSTGRES_DB
+📏 $SIZE
+🗑 Retention: ${RETENTION_DAYS}d"