create-entity-app-server 0.0.3

package/scripts/build-minify-plugins.mjs

@@ -0,0 +1,124 @@
+/**
+ * 플러그인/라우트/스케줄 선택적 난독화 빌드 스크립트
+ *
+ * src/app/{plugins,routes,schedules}/{name}/config.json 에 "minify": true 가 있는 항목만
+ * esbuild(minify) → javascript-obfuscator 로 인플레이스 난독화한다.
+ *
+ * 사용:
+ *   node scripts/build-minify-plugins.mjs
+ */
+
+import { readdirSync, readFileSync, existsSync, writeFileSync } from "fs";
+import { execSync } from "child_process";
+import JavaScriptObfuscator from "javascript-obfuscator";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+
+/**
+ * 지정한 src 디렉토리의 하위 항목 중 config.json에 minify: true 인 것들을 난독화한다.
+ * routes처럼 중첩 구조(account/register)를 지원하기 위해 재귀적으로 탐색한다.
+ */
+function collectMinifyTargets(srcDir, distDir) {
+    const targets = [];
+    if (!existsSync(srcDir)) return targets;
+
+    const entries = readdirSync(srcDir, { withFileTypes: true }).filter((d) =>
+        d.isDirectory(),
+    );
+    for (const entry of entries) {
+        const configPath = path.join(srcDir, entry.name, "config.json");
+        if (existsSync(configPath)) {
+            let config;
+            try {
+                config = JSON.parse(readFileSync(configPath, "utf-8"));
+            } catch {
+                continue;
+            }
+            if (config.minify) {
+                targets.push({
+                    name: entry.name,
+                    dist: path.join(distDir, entry.name),
+                });
+            }
+        }
+        // 중첩 디렉토리 재귀 탐색 (예: routes/account/register)
+        const nested = collectMinifyTargets(
+            path.join(srcDir, entry.name),
+            path.join(distDir, entry.name),
+        );
+        targets.push(...nested);
+    }
+    return targets;
+}
+
+const CATEGORIES = [
+    { label: "plugins", src: "src/app/plugins", dist: "dist/app/plugins" },
+    { label: "routes", src: "src/app/routes", dist: "dist/app/routes" },
+    {
+        label: "schedules",
+        src: "src/app/schedules",
+        dist: "dist/app/schedules",
+    },
+];
+
+let minified = 0;
+
+for (const { label, src, dist } of CATEGORIES) {
+    const targets = collectMinifyTargets(
+        path.join(ROOT, src),
+        path.join(ROOT, dist),
+    );
+
+    for (const { name, dist: targetDist } of targets) {
+        if (!existsSync(targetDist)) {
+            console.warn(
+                `        ✗ dist not found for ${label}/${name}, skipping`,
+            );
+            continue;
+        }
+
+        console.log(`        ✓ minifying: ${label}/${name}`);
+
+        const files = execSync(`find "${targetDist}" -name "*.ts"`, {
+            encoding: "utf-8",
+            cwd: ROOT,
+        })
+            .trim()
+            .split("\n")
+            .filter(Boolean);
+
+        for (const file of files) {
+            // 1단계: esbuild로 TS → minified JS
+            const minified_src = execSync(`npx esbuild --minify "${file}"`, {
+                encoding: "utf-8",
+                cwd: ROOT,
+            });
+
+            // 2단계: javascript-obfuscator로 문자열 암호화 + 제어 흐름 난독화
+            const obfuscated = JavaScriptObfuscator.obfuscate(minified_src, {
+                compact: true,
+                controlFlowFlattening: true,
+                controlFlowFlatteningThreshold: 0.5,
+                deadCodeInjection: true,
+                deadCodeInjectionThreshold: 0.2,
+                identifierNamesGenerator: "hexadecimal",
+                renameGlobals: false,
+                stringArray: true,
+                stringArrayEncoding: ["base64"],
+                stringArrayThreshold: 0.75,
+                splitStrings: true,
+                splitStringsChunkLength: 5,
+            });
+
+            writeFileSync(file, obfuscated.getObfuscatedCode());
+        }
+
+        minified++;
+    }
+}
+
+if (minified === 0) {
+    console.log("[minify] no targets with minify:true, skipping");
+}

package/scripts/build-obfuscate-system.mjs

@@ -0,0 +1,38 @@
+/**
+ * system.js / system-api.js 난독화
+ *
+ * esbuild 번들 결과물에 javascript-obfuscator를 적용한다.
+ * 사용:
+ *   node scripts/build-obfuscate-system.mjs
+ */
+
+import { readFileSync, writeFileSync, existsSync } from "fs";
+import JavaScriptObfuscator from "javascript-obfuscator";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const TARGETS = ["dist/system.js", "dist/system-api.js"];
+
+for (const rel of TARGETS) {
+    const file = path.join(ROOT, rel);
+    if (!existsSync(file)) continue;
+
+    const src = readFileSync(file, "utf-8");
+    const result = JavaScriptObfuscator.obfuscate(src, {
+        compact: true,
+        controlFlowFlattening: true,
+        controlFlowFlatteningThreshold: 0.5,
+        deadCodeInjection: true,
+        deadCodeInjectionThreshold: 0.2,
+        identifierNamesGenerator: "hexadecimal",
+        renameGlobals: false,
+        stringArray: true,
+        stringArrayEncoding: ["base64"],
+        stringArrayThreshold: 0.75,
+        splitStrings: true,
+        splitStringsChunkLength: 5,
+    });
+
+    writeFileSync(file, result.getObfuscatedCode());
+}

package/scripts/build.sh

@@ -0,0 +1,140 @@
+#!/bin/bash
+# build.sh — Gateway TypeScript 빌드 + dist/ 패키징
+#
+# dist/ 구조:
+#   system.js       — 난독화 번들 (서버 코어, 수정 불가)
+#   system-api.js   — 공개 API 번들 (ok/fail/logger/entityServer/errors/db)
+#   app/            — 사용자 편집 가능한 TypeScript 소스
+#   configs/        — 설정 파일
+#   entities/       — 엔티티 스키마
+#   templates/      — 확장 템플릿
+#   scripts/        — 운영 스크립트
+#   docs/           — 문서 (design/ 제외)
+#   tsconfig.json   — @gateway/api @app/* 경로 별칭 (tsx 런타임 경로 해석용)
+#   .env            — .env.example 복사본 (초기값)
+#
+# 실행:
+#   ./scripts/build.sh        — 빌드 + 패키징
+#   ./scripts/build.sh --no-tar — tar.gz 없이 빌드만
+
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+cd "$PROJECT_ROOT"
+
+VERSION=$(grep '"version"' package.json | head -1 | sed 's/.*: *"\([^"]*\)".*/\1/')
+COMMIT=$(git rev-parse --short HEAD 2>/dev/null || echo "unknown")
+BUILD_TIME=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+echo ""
+echo "  Entity Server Gateway v${VERSION}  ·  ${COMMIT}  ·  ${BUILD_TIME}"
+echo ""
+
+# ─── [1/4] TypeScript 빌드 (난독화 번들 + 타입 체크) ──────────────────────────
+
+echo "  [1/4] Building TypeScript..."
+npm run build
+node "$SCRIPT_DIR/build-obfuscate-system.mjs" 2>&1 | grep -v "\[javascript-obfuscator\]" || true
+echo "        ✓ dist/system.js      (난독화 번들)"
+echo "        ✓ dist/system-api.js  (공개 API 번들)"
+
+# ─── [2/4] 소스 복사 ──────────────────────────────────────────────────────────
+
+echo "  [2/4] Copying sources..."
+
+# 이전 빌드 잔재 system/ 폴더 제거 (system-api.js 번들로 대체됨)
+rm -rf dist/system
+
+# app/ — 사용자 편집 가능 TypeScript 소스
+rm -rf dist/app
+cp -r src/app dist/app
+
+# 플러그인 config 초기화:
+#   - config.example.json 이 있는 플러그인만: config.json 교체 (enabled: false 초기 상태)
+#   - config.example.json 이 없는 플러그인: 원본 config.json 유지
+find dist/app/plugins -maxdepth 2 -name "config.example.json" | while read -r f; do
+    dir="$(dirname "$f")"
+    rm -f "$dir/config.json"
+    cp "$f" "$dir/config.json"
+    rm -f "$f"
+done
+
+echo "        ✓ dist/app/      (편집 가능 소스, config.json ← config.example.json)"
+
+# deploy: false 항목을 dist에서 제거
+for category in plugins routes schedules; do
+    src_base="src/app/${category}"
+    dist_base="dist/app/${category}"
+    for cfg in "${src_base}"/*/config.json "${src_base}"/*/*/config.json; do
+        [ -f "$cfg" ] || continue
+        if grep -q '"deploy"[[:space:]]*:[[:space:]]*false' "$cfg" 2>/dev/null; then
+            rel="${cfg#${src_base}/}"
+            name="${rel%/config.json}"
+            rm -rf "${dist_base}/${name}"
+            echo "        ✗ app/${category}/${name} (배포 제외)"
+        fi
+    done
+done
+
+# 난독화 실행 (복사 후 dist .ts 파일 인플레이스 처리)
+node "$SCRIPT_DIR/build-minify-plugins.mjs" 2>&1 | grep -v "\[javascript-obfuscator\]" || true
+
+# tsconfig.json — tsx 런타임 경로 별칭 (@system/* @app/*)
+cp "$SCRIPT_DIR/dist-tsconfig.json" dist/tsconfig.json
+echo "        ✓ dist/tsconfig.json"
+
+# ─── [3/4] 설정·리소스 복사 ────────────────────────────────────────────────────
+
+echo "  [3/4] Packaging resources..."
+
+# configs/
+if [ -d "configs" ]; then
+    rm -rf dist/configs && mkdir -p dist/configs
+    cp -r configs/. dist/configs/
+fi
+
+# entities/
+if [ -d "entities" ]; then
+    rm -rf dist/entities && mkdir -p dist/entities
+    cp -r entities/. dist/entities/
+fi
+
+# scripts/
+mkdir -p dist/scripts
+for script in reset-all.sh run.sh entity.sh; do
+    [ -f "scripts/$script" ] && cp "scripts/$script" dist/scripts/
+done
+
+# docs/ (design/ 제외)
+if [ -d "docs" ]; then
+    rm -rf dist/docs
+    cp -r docs dist/docs
+    rm -rf dist/docs/design
+fi
+
+# .env
+[ -f ".env.example" ] && cp .env.example dist/.env
+
+echo "        ✓ configs/ entities/ scripts/ docs/ .env"
+
+# ─── [4/4] tar.gz 패키징 ──────────────────────────────────────────────────────
+
+if [ "$1" != "--no-tar" ]; then
+    echo "  [4/4] Creating dist.tar.gz..."
+    (cd dist && tar -czf "$PROJECT_ROOT/dist.tar.gz" .)
+    echo "        ✓ dist.tar.gz"
+else
+    echo "  [4/4] Skipped dist.tar.gz (--no-tar)"
+fi
+
+echo ""
+echo "  Done."
+echo ""
+echo "  스크립트 사용법:"
+echo "    ./scripts/run.sh start    # 프로덕션 실행"
+echo "    ./scripts/run.sh stop     # 서버 종료"
+echo "    ./scripts/run.sh dev      # 개발 모드 (tsx watch)"
+echo ""
+

package/scripts/dist-tsconfig.json

@@ -0,0 +1,18 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "ESNext",
+        "moduleResolution": "bundler",
+        "allowImportingTsExtensions": true,
+        "noEmit": true,
+        "lib": ["ES2022"],
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "resolveJsonModule": true,
+        "paths": {
+            "@gateway/api": ["./system-api.js"],
+            "@app/*": ["./app/*"]
+        }
+    }
+}

package/scripts/entity.sh

@@ -0,0 +1,224 @@
+#!/bin/bash
+# entity.sh — Gateway 엔티티 테이블 관리
+#
+# entities/ 폴더의 JSON 스키마를 entity-server HTTP API로 생성/초기화/비우기합니다.
+# (.env의 ENTITY_SERVER_URL + ENTITY_API_KEY 사용)
+#
+# 사용법:
+#   ./scripts/entity.sh --entity=<name> [--reset|--truncate] [--apply]
+#
+# 옵션:
+#   --entity=<name>  엔티티명 (생략 시 전체 대상)
+#   --reset          테이블 드롭 후 재생성
+#   --truncate       데이터 전체 삭제 + AUTO_INCREMENT 초기화
+#   --apply          실제 실행 (기본은 dry-run)
+#
+# 예제:
+#   ./scripts/entity.sh --entity=llm_conversation --apply
+#   ./scripts/entity.sh --entity=llm_conversation --reset --apply
+#   ./scripts/entity.sh --entity=llm_conversation --truncate --apply
+#   ./scripts/entity.sh --apply   (전체 엔티티 생성)
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+cd "$PROJECT_ROOT"
+
+# .env 로드
+[ -f ".env" ] && set -o allexport && source .env && set +o allexport
+
+# ── 도움말 ────────────────────────────────────────────────────────────────────
+_show_help() {
+    echo ""
+    echo "  Gateway 엔티티 테이블 관리"
+    echo "  ========================="
+    echo ""
+    echo "  사용법: $0 --entity=<name> [--reset|--truncate] [--apply]"
+    echo ""
+    echo "  옵션:"
+    echo "    --entity=<name>   엔티티명 (생략 시 전체 대상)"
+    echo "    --reset           테이블 드롭 후 재생성"
+    echo "    --truncate        데이터 전체 삭제 + AUTO_INCREMENT 초기화"
+    echo "    --apply           실제 실행 (기본은 dry-run)"
+    echo ""
+    echo "  예제:"
+    echo "    $0 --entity=llm_conversation --apply          # 테이블 생성"
+    echo "    $0 --entity=llm_conversation --reset --apply  # 드롭 후 재생성"
+    echo "    $0 --entity=llm_conversation --truncate --apply  # 데이터 비우기"
+    echo "    $0 --apply                                    # 전체 엔티티 생성"
+    echo ""
+}
+
+if [ $# -eq 0 ]; then
+    _show_help
+    exit 0
+fi
+
+# ── 인자 파싱 ─────────────────────────────────────────────────────────────────
+ENTITY_NAME=""
+ACTION="create"   # create | reset | truncate
+DRY_RUN=true
+
+for arg in "$@"; do
+    case "$arg" in
+        --entity=*) ENTITY_NAME="${arg#--entity=}" ;;
+        --reset)    ACTION="reset" ;;
+        --truncate) ACTION="truncate" ;;
+        --apply)    DRY_RUN=false ;;
+        --dry-run)  DRY_RUN=true ;;
+        *)
+            echo "❌ 알 수 없는 옵션: $arg"
+            _show_help
+            exit 1
+            ;;
+    esac
+done
+
+# ── 환경변수 확인 ─────────────────────────────────────────────────────────────
+if [ -z "${ENTITY_SERVER_URL:-}" ]; then
+    echo "❌ ENTITY_SERVER_URL이 설정되지 않았습니다 (.env 확인)"
+    exit 1
+fi
+if [ -z "${ENTITY_API_KEY:-}" ]; then
+    echo "❌ ENTITY_API_KEY가 설정되지 않았습니다 (.env 확인)"
+    exit 1
+fi
+
+# ── HTTP 헬퍼 ────────────────────────────────────────────────────────────────
+if command -v curl &>/dev/null; then
+    _post_json() { curl -sS -X POST -H "Authorization: Bearer $ENTITY_API_KEY" -H "Content-Type: application/json" --data-binary @"$1" "$2" 2>&1; }
+    _post()      { curl -sS -X POST -H "Authorization: Bearer $ENTITY_API_KEY" "$1" 2>&1; }
+elif command -v wget &>/dev/null; then
+    _post_json() { wget -qO- --method=POST --header="Authorization: Bearer $ENTITY_API_KEY" --header="Content-Type: application/json" --body-file="$1" "$2" 2>&1; }
+    _post()      { wget -qO- --method=POST --header="Authorization: Bearer $ENTITY_API_KEY" "$1" 2>&1; }
+else
+    echo "❌ curl 또는 wget이 필요합니다."
+    exit 1
+fi
+
+# ── 단일 엔티티 작업 ─────────────────────────────────────────────────────────
+_run_entity() {
+    local name="$1"
+    local schema_file
+    schema_file=$(find "$PROJECT_ROOT/entities" -iname "${name}.json" | head -1)
+
+    case "$ACTION" in
+        create)
+            if [ -z "$schema_file" ]; then
+                echo "  ✗ $name — 스키마 파일 없음 (entities/${name}.json)"
+                return 1
+            fi
+            if [ "$DRY_RUN" = true ]; then
+                echo "  [dry-run] create: $name  (${schema_file#$PROJECT_ROOT/})"
+                return 0
+            fi
+            response=$(_post_json "$schema_file" "${ENTITY_SERVER_URL}/v1/admin/${name}/create" 2>&1)
+            ;;
+        reset)
+            if [ "$DRY_RUN" = true ]; then
+                echo "  [dry-run] reset: $name"
+                return 0
+            fi
+            response=$(_post "${ENTITY_SERVER_URL}/v1/admin/${name}/reset?confirm=RESET_${name}" 2>&1)
+            ;;
+        truncate)
+            if [ "$DRY_RUN" = true ]; then
+                echo "  [dry-run] truncate: $name"
+                return 0
+            fi
+            response=$(_post "${ENTITY_SERVER_URL}/v1/admin/${name}/truncate?confirm=TRUNCATE_${name}" 2>&1)
+            ;;
+    esac
+
+    if echo "$response" | grep -q '"ok":true'; then
+        echo "  ✓ ${ACTION}: $name"
+    else
+        echo "  ✗ ${ACTION}: $name"
+        echo "    $(echo "$response" | head -3)"
+        return 1
+    fi
+}
+
+# ── 플러그인 활성화 여부 확인 ─────────────────────────────────────────────────
+# entities/{plugin}/ 서브폴더에 대응하는 src/app/plugins/{plugin}/config.json 의
+# enabled 값을 확인한다. config.json 이 없거나 enabled 가 true(기본값)이면 0 반환.
+_plugin_enabled() {
+    local plugin="$1"
+    local config="$PROJECT_ROOT/src/app/plugins/${plugin}/config.json"
+    [ -f "$config" ] || return 0  # config 없으면 활성화 간주
+    python3 -c "
+import json, sys
+try:
+    d = json.load(open('$config'))
+except Exception:
+    sys.exit(0)
+sys.exit(0 if d.get('enabled', True) else 1)
+" 2>/dev/null
+}
+
+# ── 실행 ─────────────────────────────────────────────────────────────────────
+ENTITIES_DIR="$PROJECT_ROOT/entities"
+if [ ! -d "$ENTITIES_DIR" ]; then
+    echo "❌ entities/ 폴더가 없습니다: $ENTITIES_DIR"
+    exit 1
+fi
+
+echo ""
+echo "  entity ${ACTION}  |  서버: ${ENTITY_SERVER_URL}"
+echo ""
+
+if [ -n "$ENTITY_NAME" ]; then
+    # 단일 엔티티
+    _run_entity "$ENTITY_NAME"
+else
+    # --entity 없이 --reset / --truncate 는 안내 후 종료
+    if [ "$ACTION" != "create" ]; then
+        echo "  ⚠️  --reset / --truncate 는 --entity=<name> 이 필요합니다."
+        echo "      전체 초기화는 reset-all.sh 를 사용하세요."
+        echo ""
+        exit 1
+    fi
+
+    # 전체 엔티티 create
+    SCHEMA_FILES=$(find "$ENTITIES_DIR" -name "*.json" | sort)
+    if [ -z "$SCHEMA_FILES" ]; then
+        echo "  등록할 엔티티 스키마 파일이 없습니다."
+        exit 0
+    fi
+
+    if [ "$DRY_RUN" = true ]; then
+        echo "  [dry-run] 생성 대상:"
+        while IFS= read -r f; do
+            parent="$(dirname "$f")"
+            plugin="$(basename "$parent")"
+            if [ "$parent" != "$ENTITIES_DIR" ] && ! _plugin_enabled "$plugin"; then
+                echo "    ⏭  ${f#$PROJECT_ROOT/}  (plugin '$plugin' disabled)"
+            else
+                echo "    - ${f#$PROJECT_ROOT/}"
+            fi
+        done <<< "$SCHEMA_FILES"
+        echo ""
+        echo "  실제 실행: $0 --apply"
+        echo ""
+        exit 0
+    fi
+
+    SUCCESS=0; FAIL=0; SKIP=0
+    while IFS= read -r schema_file; do
+        parent="$(dirname "$schema_file")"
+        plugin="$(basename "$parent")"
+        if [ "$parent" != "$ENTITIES_DIR" ] && ! _plugin_enabled "$plugin"; then
+            echo "  ⏭  skip: $(basename "$schema_file" .json)  (plugin '$plugin' disabled)"
+            SKIP=$((SKIP+1))
+            continue
+        fi
+        name=$(basename "$schema_file" .json)
+        _run_entity "$name" && SUCCESS=$((SUCCESS+1)) || FAIL=$((FAIL+1))
+    done <<< "$SCHEMA_FILES"
+    echo ""
+    echo "  완료: 성공 ${SUCCESS}, 실패 ${FAIL}, 스킵 ${SKIP}"
+fi
+
+echo ""