create-entity-server 0.0.15 → 0.0.23

package/template/scripts/update-server.sh

@@ -19,6 +19,56 @@ REPO="ehfuse/entity-server"
 BINARIES=("entity-server" "entity-cli")
 DIST_DIRS=("scripts" "samples")
 
+_find_running_pid() {
+    local pid_file="$PROJECT_ROOT/.run/entity-server.pid"
+    if [ -f "$pid_file" ]; then
+        local pid
+        pid=$(cat "$pid_file" 2>/dev/null)
+        if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
+            echo "$pid"
+            return 0
+        fi
+    fi
+
+    pgrep -f "${PROJECT_ROOT}/(bin/)?entity-server( |$)" | head -n 1
+}
+
+_ensure_server_stopped() {
+    local pid
+    pid="$(_find_running_pid)"
+
+    if [ -z "$pid" ]; then
+        return 0
+    fi
+
+    echo ""
+    echo "⚠️  현재 Entity Server가 실행 중입니다."
+    ps -p "$pid" -o pid,etime,cmd --no-headers 2>/dev/null || true
+    echo ""
+    read -r -p "업데이트를 위해 서버를 중지할까요? [y/N]: " input
+    input=$(echo "$input" | tr '[:upper:]' '[:lower:]')
+
+    if [ "$input" != "y" ] && [ "$input" != "yes" ]; then
+        echo "❌ 업데이트를 취소했습니다."
+        exit 1
+    fi
+
+    if [ -x "$PROJECT_ROOT/scripts/run.sh" ]; then
+        "$PROJECT_ROOT/scripts/run.sh" stop || true
+    else
+        kill "$pid" 2>/dev/null || true
+    fi
+
+    sleep 0.2
+    pid="$(_find_running_pid)"
+    if [ -n "$pid" ]; then
+        echo "❌ 서버 중지에 실패했습니다. 업데이트를 중단합니다."
+        exit 1
+    fi
+
+    echo "✅ 서버 중지 완료"
+}
+
 # ── 플랫폼 감지 ───────────────────────────────────────────────────────────────
 
 OS="$(uname -s)"
@@ -46,7 +96,10 @@ esac
 # ── 현재 버전 확인 ────────────────────────────────────────────────────────────
 
 _current_ver() {
-    local bin="$PROJECT_ROOT/entity-server"
+    local bin="$PROJECT_ROOT/bin/entity-server"
+    if [ ! -x "$bin" ] && [ -x "$PROJECT_ROOT/entity-server" ]; then
+        bin="$PROJECT_ROOT/entity-server"
+    fi
     if [ -x "$bin" ]; then
         "$bin" --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1 || echo "(알 수 없음)"
     else
@@ -100,15 +153,19 @@ _install() {
     local current_ver
     current_ver="$(_current_ver)"
 
+    _ensure_server_stopped
+
     echo ""
     echo "📦 entity-server v${target_ver} 다운로드 중... (${PLATFORM}-${ARCH_TAG})"
     echo ""
 
     # 바이너리 다운로드
+    mkdir -p "$PROJECT_ROOT/bin"
+
     for BIN in "${BINARIES[@]}"; do
         local file="${BIN}-${PLATFORM}-${ARCH_TAG}"
         local url="https://github.com/${REPO}/releases/download/v${target_ver}/${file}"
-        local dest="$PROJECT_ROOT/$BIN"
+        local dest="$PROJECT_ROOT/bin/$BIN"
 
         printf "  ↓ %-32s" "$file"
         if _download "$url" "$dest" 2>/dev/null; then

package/template/samples/entities/order_notification.json

@@ -1,51 +0,0 @@
-{
-    "name": "order_notification",
-    "description": "주문 알림 예제 — 주문 생성 시 고객에게 푸시 전송",
-    "index": {
-        "customer_seq": {
-            "comment": "고객 user seq",
-            "required": true
-        },
-        "order_number": {
-            "comment": "주문 번호",
-            "required": true
-        },
-        "status": {
-            "comment": "주문 상태",
-            "type": ["placed", "confirmed", "shipped", "delivered", "cancelled"],
-            "default": "placed"
-        },
-        "total_amount": {
-            "comment": "주문 금액",
-            "type": "uint"
-        }
-    },
-    "hooks": {
-        "after_insert": [
-            {
-                "type": "push",
-                "target_user_field": "customer_seq",
-                "title": "주문 접수",
-                "push_body": "주문 #${new.order_number}이 접수되었습니다. 금액: ${new.total_amount}원",
-                "push_data": {
-                    "action": "order_created",
-                    "order_seq": "${new.seq}",
-                    "order_number": "${new.order_number}"
-                }
-            }
-        ],
-        "after_update": [
-            {
-                "type": "push",
-                "target_user_field": "customer_seq",
-                "title": "주문 상태 변경",
-                "push_body": "주문 #${new.order_number} 상태: ${new.status}",
-                "push_data": {
-                    "action": "order_updated",
-                    "order_seq": "${new.seq}",
-                    "status": "${new.status}"
-                }
-            }
-        ]
-    }
-}

package/template/samples/react/src/api/entityServerClient.ts

@@ -1,413 +0,0 @@
-/**
- * Entity Server API 클라이언트 (React / 브라우저)
- *
- * 브라우저 환경에서는 HMAC secret을 노출할 수 없으므로 JWT Bearer 토큰 방식을 사용합니다.
- *
- * 패킷 암호화 지원:
- *   서버가 application/octet-stream 으로 응답하면 자동으로 복호화합니다.
- *   복호화 키: sha256(access_token)
- *   의존성: @noble/ciphers, @noble/hashes  (npm install @noble/ciphers @noble/hashes)
- *
- * 환경변수 (Vite):
- *   VITE_ENTITY_SERVER_URL=http://localhost:47200
- *   VITE_PACKET_MAGIC_LEN=4  (서버 packet_magic_len 과 동일하게)
- *
- * 트랜잭션 사용 예:
- *   await es.transStart();
- *   try {
- *     const orderRef  = await es.submit('order', { user_seq: 1, total: 9900 });        // seq: "$tx.0"
- *     await es.submit('order_item', { order_seq: orderRef.seq, item_seq: 5 });          // "$tx.0" 자동 치환
- *     const result    = await es.transCommit();
- *     const orderSeq  = result.results[0].seq;                                          // 실제 seq
- *   } catch (e) {
- *     await es.transRollback();
- *   }
- */
-
-import { xchacha20_poly1305 } from "@noble/ciphers/chacha";
-import { sha256 } from "@noble/hashes/sha2";
-
-export interface EntityListParams {
-    page?: number;
-    limit?: number;
-    orderBy?: string;
-}
-
-export interface EntityQueryFilter {
-    field: string;
-    op: "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "like" | "in";
-    value: unknown;
-}
-
-export interface RegisterPushDeviceOptions {
-    platform?: string;
-    deviceType?: string;
-    browser?: string;
-    browserVersion?: string;
-    pushEnabled?: boolean;
-    transactionId?: string;
-}
-
-export class EntityServerClient {
-    private baseUrl: string;
-    private token: string;
-    private magicLen: number;
-    private activeTxId: string | null = null;
-
-    constructor(baseUrl?: string, token?: string) {
-        this.baseUrl = (
-            baseUrl ??
-            (import.meta as unknown as Record<string, Record<string, string>>)
-                .env?.VITE_ENTITY_SERVER_URL ??
-            "http://localhost:47200"
-        ).replace(/\/$/, "");
-        this.token = token ?? "";
-        const envMagic = (
-            import.meta as unknown as Record<string, Record<string, string>>
-        ).env?.VITE_PACKET_MAGIC_LEN;
-        this.magicLen = envMagic ? Number(envMagic) : 4;
-    }
-
-    setToken(token: string): void {
-        this.token = token;
-    }
-
-    // ─── 인증 ────────────────────────────────────────────────────────────────
-
-    async login(
-        email: string,
-        password: string,
-    ): Promise<{
-        access_token: string;
-        refresh_token: string;
-        expires_in: number;
-    }> {
-        const data = await this.request<{
-            data: {
-                access_token: string;
-                refresh_token: string;
-                expires_in: number;
-            };
-        }>("POST", "/v1/auth/login", { email, passwd: password }, false);
-        this.token = data.data.access_token;
-        return data.data;
-    }
-
-    async refreshToken(
-        refreshToken: string,
-    ): Promise<{ access_token: string; expires_in: number }> {
-        const data = await this.request<{
-            data: { access_token: string; expires_in: number };
-        }>("POST", "/v1/auth/refresh", { refresh_token: refreshToken }, false);
-        this.token = data.data.access_token;
-        return data.data;
-    }
-
-    // ─── 트랜잭션 ──────────────────────────────────────────────────────────────
-
-    /**
-     * 트랜잭션 시작 — 서버에 트랜잭션 큐를 등록하고 transaction_id 를 반환합니다.
-     * 이후 submit / delete 가 서버 큐에 쌓이고 transCommit() 시 일괄 처리됩니다.
-     */
-    async transStart(): Promise<string> {
-        const res = await this.request<{ ok: boolean; transaction_id: string }>(
-            "POST",
-            "/v1/transaction/start",
-            undefined,
-            false,
-        );
-        this.activeTxId = res.transaction_id;
-        return this.activeTxId;
-    }
-
-    /**
-     * 트랜잭션 단위로 변경사항을 롤백합니다.
-     * transactionId 생략 시 transStart() 로 시작한 활성 트랜잭션을 사용합니다.
-     */
-    transRollback(transactionId?: string): Promise<{ ok: boolean }> {
-        const txId = transactionId ?? this.activeTxId;
-        if (!txId)
-            return Promise.reject(
-                new Error("No active transaction. Call transStart() first."),
-            );
-        this.activeTxId = null;
-        return this.request("POST", `/v1/transaction/rollback/${txId}`);
-    }
-
-    /**
-     * 트랜잭션 커밋 — 서버 큐에 쌓인 작업을 단일 DB 트랜잭션으로 일괄 처리합니다.
-     * transactionId 생략 시 transStart() 로 시작한 활성 트랜잭션을 사용합니다.
-     */
-    transCommit(
-        transactionId?: string,
-    ): Promise<{ ok: boolean; results: unknown[] }> {
-        const txId = transactionId ?? this.activeTxId;
-        if (!txId)
-            return Promise.reject(
-                new Error("No active transaction. Call transStart() first."),
-            );
-        this.activeTxId = null;
-        return this.request("POST", `/v1/transaction/commit/${txId}`);
-    }
-
-    // ─── CRUD ────────────────────────────────────────────────────────────────
-
-    get<T = unknown>(
-        entity: string,
-        seq: number,
-    ): Promise<{ ok: boolean; data: T }> {
-        return this.request("GET", `/v1/entity/${entity}/${seq}`);
-    }
-
-    list<T = unknown>(
-        entity: string,
-        params: EntityListParams = {},
-    ): Promise<{ ok: boolean; data: T[]; total: number }> {
-        const q = buildQuery({ page: 1, limit: 20, ...params });
-        return this.request("GET", `/v1/entity/${entity}/list?${q}`);
-    }
-
-    count(entity: string): Promise<{ ok: boolean; count: number }> {
-        return this.request("GET", `/v1/entity/${entity}/count`);
-    }
-
-    query<T = unknown>(
-        entity: string,
-        filter: EntityQueryFilter[] = [],
-        params: EntityListParams = {},
-    ): Promise<{ ok: boolean; data: T[]; total: number }> {
-        const q = buildQuery({ page: 1, limit: 20, ...params });
-        return this.request("POST", `/v1/entity/${entity}/query?${q}`, filter);
-    }
-
-    submit<T = unknown>(
-        entity: string,
-        data: Record<string, unknown>,
-        opts: { transactionId?: string } = {},
-    ): Promise<{ ok: boolean; seq?: number; data?: T }> {
-        const txId = opts.transactionId ?? this.activeTxId;
-        const extra = txId ? { "X-Transaction-ID": txId } : {};
-        return this.request(
-            "POST",
-            `/v1/entity/${entity}/submit`,
-            data,
-            true,
-            extra,
-        );
-    }
-
-    delete(
-        entity: string,
-        seq: number,
-        opts: { transactionId?: string; hard?: boolean } = {},
-    ): Promise<{ ok: boolean }> {
-        const q = opts.hard ? "?hard=true" : "";
-        const txId = opts.transactionId ?? this.activeTxId;
-        const extra = txId ? { "X-Transaction-ID": txId } : {};
-        return this.request(
-            "DELETE",
-            `/v1/entity/${entity}/delete/${seq}${q}`,
-            undefined,
-            true,
-            extra,
-        );
-    }
-
-    history<T = unknown>(
-        entity: string,
-        seq: number,
-        params: EntityListParams = {},
-    ): Promise<{ ok: boolean; data: T[] }> {
-        const q = buildQuery({ page: 1, limit: 50, ...params });
-        return this.request("GET", `/v1/entity/${entity}/history/${seq}?${q}`);
-    }
-
-    rollback(entity: string, historySeq: number): Promise<{ ok: boolean }> {
-        return this.request(
-            "POST",
-            `/v1/entity/${entity}/rollback/${historySeq}`,
-        );
-    }
-
-    push<T = unknown>(
-        pushEntity: string,
-        payload: Record<string, unknown>,
-        opts: { transactionId?: string } = {},
-    ): Promise<{ ok: boolean; seq?: number; data?: T }> {
-        return this.submit<T>(pushEntity, payload, opts);
-    }
-
-    pushLogList<T = unknown>(
-        params: EntityListParams = {},
-    ): Promise<{ ok: boolean; data: T[]; total: number }> {
-        return this.list<T>("push_log", params);
-    }
-
-    registerPushDevice<T = unknown>(
-        accountSeq: number,
-        deviceId: string,
-        pushToken: string,
-        opts: RegisterPushDeviceOptions = {},
-    ): Promise<{ ok: boolean; seq?: number; data?: T }> {
-        const {
-            platform,
-            deviceType,
-            browser,
-            browserVersion,
-            pushEnabled = true,
-            transactionId,
-        } = opts;
-
-        return this.submit<T>(
-            "account_device",
-            {
-                id: deviceId,
-                account_seq: accountSeq,
-                push_token: pushToken,
-                push_enabled: pushEnabled,
-                ...(platform ? { platform } : {}),
-                ...(deviceType ? { device_type: deviceType } : {}),
-                ...(browser ? { browser } : {}),
-                ...(browserVersion ? { browser_version: browserVersion } : {}),
-            },
-            { transactionId },
-        );
-    }
-
-    updatePushDeviceToken<T = unknown>(
-        deviceSeq: number,
-        pushToken: string,
-        opts: { pushEnabled?: boolean; transactionId?: string } = {},
-    ): Promise<{ ok: boolean; seq?: number; data?: T }> {
-        const { pushEnabled = true, transactionId } = opts;
-        return this.submit<T>(
-            "account_device",
-            {
-                seq: deviceSeq,
-                push_token: pushToken,
-                push_enabled: pushEnabled,
-            },
-            { transactionId },
-        );
-    }
-
-    disablePushDevice<T = unknown>(
-        deviceSeq: number,
-        opts: { transactionId?: string } = {},
-    ): Promise<{ ok: boolean; seq?: number; data?: T }> {
-        return this.submit<T>(
-            "account_device",
-            {
-                seq: deviceSeq,
-                push_enabled: false,
-            },
-            { transactionId: opts.transactionId },
-        );
-    }
-
-    readRequestBody<T = Record<string, unknown>>(
-        body: ArrayBuffer | Uint8Array | string | T | null | undefined,
-        contentType = "application/json",
-        requireEncrypted = false,
-    ): T {
-        const lowered = contentType.toLowerCase();
-        const isEncrypted = lowered.includes("application/octet-stream");
-
-        if (requireEncrypted && !isEncrypted) {
-            throw new Error(
-                "Encrypted request required: Content-Type must be application/octet-stream",
-            );
-        }
-
-        if (isEncrypted) {
-            if (body == null) {
-                throw new Error("Encrypted request body is empty");
-            }
-            if (body instanceof ArrayBuffer) {
-                return this.decryptPacket<T>(body);
-            }
-            if (body instanceof Uint8Array) {
-                const sliced = body.buffer.slice(
-                    body.byteOffset,
-                    body.byteOffset + body.byteLength,
-                );
-                return this.decryptPacket<T>(sliced);
-            }
-            throw new Error(
-                "Encrypted request body must be ArrayBuffer or Uint8Array",
-            );
-        }
-
-        if (body == null || body === "") return {} as T;
-        if (typeof body === "string") return JSON.parse(body) as T;
-        return body as T;
-    }
-
-    private async request<T>(
-        method: string,
-        path: string,
-        body?: unknown,
-        withAuth = true,
-        extraHeaders: Record<string, string> = {},
-    ): Promise<T> {
-        const headers: Record<string, string> = {
-            "Content-Type": "application/json",
-            ...extraHeaders,
-        };
-        if (withAuth && this.token) {
-            headers["Authorization"] = `Bearer ${this.token}`;
-        }
-
-        const res = await fetch(this.baseUrl + path, {
-            method,
-            headers,
-            ...(body != null ? { body: JSON.stringify(body) } : {}),
-        });
-
-        const contentType = res.headers.get("Content-Type") ?? "";
-
-        // 패킷 암호화 응답: application/octet-stream → 복호화
-        if (contentType.includes("application/octet-stream")) {
-            const buffer = await res.arrayBuffer();
-            return this.decryptPacket<T>(buffer);
-        }
-
-        const data = await res.json();
-        if (!data.ok) {
-            const err = new Error(
-                data.message ?? `EntityServer error (HTTP ${res.status})`,
-            );
-            (err as { status?: number }).status = res.status;
-            throw err;
-        }
-        return data as T;
-    }
-
-    /**
-     * XChaCha20-Poly1305 패킷 복호화
-     * 포맷: [magic:magicLen][nonce:24][ciphertext+tag]
-     * 키: sha256(access_token)
-     */
-    private decryptPacket<T>(buffer: ArrayBuffer): T {
-        const key = sha256(new TextEncoder().encode(this.token));
-        const data = new Uint8Array(buffer);
-        const nonce = data.slice(this.magicLen, this.magicLen + 24);
-        const ciphertext = data.slice(this.magicLen + 24);
-        const cipher = xchacha20_poly1305(key, nonce);
-        const plaintext = cipher.decrypt(ciphertext);
-        return JSON.parse(new TextDecoder().decode(plaintext)) as T;
-    }
-}
-
-function buildQuery(params: Record<string, unknown>): string {
-    return Object.entries(params)
-        .filter(([, v]) => v != null)
-        .map(
-            ([k, v]) =>
-                `${encodeURIComponent(k === "orderBy" ? "order_by" : k)}=${encodeURIComponent(String(v))}`,
-        )
-        .join("&");
-}
-
-/** 싱글턴 인스턴스 (앱 전체 공유) */
-export const entityServer = new EntityServerClient();