mega-framework 0.1.6 → 0.1.7

package/bin/mega-ws-hub.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 // @ts-check
 /**
- * `mega ws-hub` 실행 launcher (ADR-032). 실제 로직은 src/cli/ws-hub.js.
+ * `mega ws-hub` 실행 launcher (ADR-032). 실제 로직은 src/lib/ws-hub.js.
  *
  * 사용: MEGA_WSHUB_TOKENS=tok1,tok2 [MEGA_WSHUB_PORT=3100] [MEGA_WSHUB_HOST=0.0.0.0]
  *       [MEGA_WSHUB_HEARTBEAT_MS=25000] mega-ws-hub
  */
-import { runWsHubCli } from '../src/cli/ws-hub.js'
+import { runWsHubCli } from '../src/lib/ws-hub.js'
 
 runWsHubCli().catch((err) => {
   // 부팅 실패는 fail-fast — 메시지 출력 후 비정상 종료 (P4: 이유 명확, silent X).

package/package.json

@@ -1,33 +1,53 @@
 {
   "name": "mega-framework",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Node.js 마이크로프레임웍 + CLI — Slim의 가벼움 + Rails의 관례",
   "type": "module",
   "engines": {
     "node": ">=20.6.0"
   },
   "main": "src/index.js",
+  "types": "types/index.d.ts",
+  "workspaces": [
+    "sample/crud",
+    "sample/simple"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://git.nyx-zone.com/mega/mega-framework.git"
   },
   "exports": {
-    ".": "./src/index.js",
-    "./lib": "./src/lib/index.js",
-    "./errors": "./src/errors/index.js",
-    "./auth": "./src/auth/index.js",
-    "./test": "./src/test/index.js",
+    ".": {
+      "types": "./types/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./lib": {
+      "types": "./types/lib/index.d.ts",
+      "default": "./src/lib/index.js"
+    },
+    "./errors": {
+      "types": "./types/errors/index.d.ts",
+      "default": "./src/errors/index.js"
+    },
+    "./auth": {
+      "types": "./types/auth/index.d.ts",
+      "default": "./src/auth/index.js"
+    },
+    "./test": {
+      "types": "./types/test/index.d.ts",
+      "default": "./src/test/index.js"
+    },
     "./eslint-plugin": "./src/eslint-plugin/index.js",
     "./package.json": "./package.json"
   },
   "files": [
     "src/**/*.js",
+    "types/**/*.d.ts",
     "bin/**/*.js",
     "templates/**",
     "sample/**",
     "infra/**",
     "docker-compose.yml",
-    ".env",
     ".env.example",
     "eslint.config.js",
     "vitest.config.js",
@@ -51,6 +71,7 @@
     "test:coverage": "vitest run --coverage",
     "lint": "eslint src test",
     "typecheck": "tsc -p jsconfig.json --noEmit",
+    "build:types": "rm -rf types && tsc -p tsconfig.build.json",
     "format": "prettier -w src test packages",
     "infra:up": "docker compose up -d --wait",
     "infra:down": "docker compose down -v",
@@ -58,7 +79,8 @@
     "infra:reset": "docker compose down -v && docker compose up -d --wait",
     "test:integration": "npm run infra:up && vitest run test/integration && npm run infra:down",
     "test:unit": "vitest run test/unit",
-    "prepublishOnly": "npm run lint && npm run typecheck && npm run test:unit",
+    "prepublishOnly": "npm run build:types && npm run lint && npm run typecheck && npm run test:unit",
+    "prepare": "npm run build:types",
     "release": "bash scripts/publish.sh"
   },
   "devDependencies": {
@@ -89,6 +111,7 @@
     "@fastify/swagger": "^9.7.0",
     "@fastify/swagger-ui": "^5.2.6",
     "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/core": "^2.7.1",
     "@opentelemetry/exporter-prometheus": "^0.218.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.218.0",
     "@opentelemetry/exporter-zipkin": "^2.7.1",
@@ -97,6 +120,7 @@
     "@opentelemetry/sdk-trace-base": "^2.7.1",
     "@opentelemetry/semantic-conventions": "^1.41.1",
     "ajv": "^8.20.0",
+    "ajv-formats": "^3.0.1",
     "better-sqlite3": "^12.10.0",
     "commander": "^15.0.0",
     "croner": "^10.0.1",

package/sample/crud/.env

@@ -71,7 +71,7 @@ NATS_JOBS_URL=nats://localhost:4222
 
 # ── WS Hub: 클러스터 채팅 브릿지 (ADR-059/065/137/176) ────────────────────────
 # crud 는 app.config.js 의 bridgeHub 로 /ws/chat 을 클러스터 전파한다. 허브는 `mega ws-hub`(scripts/
-# start-ws-hub.sh)로 별도 프로세스 기동. 아래 MEGA_WSHUB_* 는 src/cli/ws-hub.js 가 읽는다.
+# start-ws-hub.sh)로 별도 프로세스 기동. 아래 MEGA_WSHUB_* 는 src/lib/ws-hub.js 가 읽는다.
 # --- 허브 서버가 읽는 값 (`mega ws-hub`) ---
 # 수락 토큰 CSV(필수) — 브릿지 인증. 빈 값이면 허브 기동 실패. 운영 교체.
 MEGA_WSHUB_TOKENS=dev-bridge-token-change-me

package/sample/crud/.env.example

@@ -71,7 +71,7 @@ NATS_JOBS_URL=nats://localhost:4222
 
 # ── WS Hub: 클러스터 채팅 브릿지 (ADR-059/065/137/176) ────────────────────────
 # crud 는 app.config.js 의 bridgeHub 로 /ws/chat 을 클러스터 전파한다. 허브는 `mega ws-hub`(scripts/
-# start-ws-hub.sh)로 별도 프로세스 기동. 아래 MEGA_WSHUB_* 는 src/cli/ws-hub.js 가 읽는다.
+# start-ws-hub.sh)로 별도 프로세스 기동. 아래 MEGA_WSHUB_* 는 src/lib/ws-hub.js 가 읽는다.
 # --- 허브 서버가 읽는 값 (`mega ws-hub`) ---
 # 수락 토큰 CSV(필수) — 브릿지 인증. 빈 값이면 허브 기동 실패. 운영 교체.
 MEGA_WSHUB_TOKENS=change-me-hub-token

package/sample/crud/.mega/journal/history/20260612092543-create-users.json

@@ -0,0 +1,261 @@
+{
+  "version": 1,
+  "generatedAt": "2026-06-12T09:25:43.484Z",
+  "adapters": {
+    "primary": {
+      "driver": "postgres",
+      "models": [
+        {
+          "name": "UserLevelModel",
+          "table": "user_levels",
+          "record": {
+            "table": "user_levels",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "serial",
+                "primary": true
+              },
+              "code": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "회원 등급 코드"
+              },
+              "type_code": {
+                "type": "text",
+                "notNull": true,
+                "references": {
+                  "model": "UserTypeModel",
+                  "column": "code",
+                  "onDelete": "cascade",
+                  "table": "user_types"
+                },
+                "comment": "회원 유형 코드"
+              },
+              "sort_order": {
+                "type": "integer",
+                "notNull": true,
+                "default": 0,
+                "comment": "정렬 순서"
+              },
+              "name": {
+                "type": "text",
+                "notNull": true,
+                "comment": "회원 등급명"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": [
+              {
+                "columns": [
+                  "type_code"
+                ],
+                "name": "idx_user_levels_type_code"
+              }
+            ]
+          }
+        },
+        {
+          "name": "UserModel",
+          "table": "users",
+          "record": {
+            "table": "users",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "bigSerial",
+                "primary": true
+              },
+              "uuid": {
+                "type": "uuid",
+                "notNull": true,
+                "default": {
+                  "raw": "gen_random_uuid()"
+                },
+                "comment": "고유값"
+              },
+              "username": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "로그인 아이디"
+              },
+              "password_hash": {
+                "type": "text",
+                "notNull": true,
+                "comment": "비밀번호 해시"
+              },
+              "type_code": {
+                "type": "text",
+                "notNull": true,
+                "default": "USER",
+                "comment": "회원 유형"
+              },
+              "level_code": {
+                "type": "text",
+                "notNull": true,
+                "default": "lv1",
+                "comment": "회원 등급"
+              },
+              "name": {
+                "type": "text",
+                "notNull": true,
+                "comment": "실명"
+              },
+              "nickname": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "별명"
+              },
+              "email": {
+                "type": "text",
+                "comment": "이메일"
+              },
+              "phone_number": {
+                "type": "text",
+                "comment": "전화번호"
+              },
+              "last_login_at": {
+                "type": "timestamptz",
+                "comment": "마지막 로그인 시간"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": [
+              {
+                "columns": [
+                  "uuid"
+                ],
+                "name": "idx_users_uuid",
+                "unique": true
+              },
+              {
+                "columns": [
+                  "email"
+                ],
+                "name": "idx_users_email"
+              },
+              {
+                "columns": [
+                  "type_code"
+                ],
+                "name": "idx_users_type_code"
+              },
+              {
+                "columns": [
+                  "level_code"
+                ],
+                "name": "idx_users_level_code"
+              }
+            ]
+          }
+        },
+        {
+          "name": "UserTypeModel",
+          "table": "user_types",
+          "record": {
+            "table": "user_types",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "serial",
+                "primary": true
+              },
+              "code": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "회원 유형 코드"
+              },
+              "sort_order": {
+                "type": "integer",
+                "notNull": true,
+                "default": 0,
+                "comment": "정렬 순서"
+              },
+              "name": {
+                "type": "text",
+                "notNull": true,
+                "comment": "회원 유형명"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": []
+          }
+        },
+        {
+          "name": "WalletModel",
+          "table": "wallets",
+          "record": {
+            "table": "wallets",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "serial",
+                "primary": true
+              },
+              "user_id": {
+                "type": "bigInteger",
+                "notNull": true,
+                "references": {
+                  "model": "UserModel",
+                  "column": "id",
+                  "onDelete": "cascade",
+                  "table": "users"
+                },
+                "comment": "회원 ID"
+              },
+              "balance": {
+                "type": "decimal",
+                "precision": 20,
+                "scale": 4,
+                "notNull": true,
+                "default": 0,
+                "comment": "잔액"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": [
+              {
+                "columns": [
+                  "user_id"
+                ],
+                "name": "idx_wallets_user_id"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  }
+}

package/sample/crud/.mega/journal/snapshot.json

@@ -0,0 +1,261 @@
+{
+  "version": 1,
+  "generatedAt": "2026-06-12T09:25:43.485Z",
+  "adapters": {
+    "primary": {
+      "driver": "postgres",
+      "models": [
+        {
+          "name": "UserLevelModel",
+          "table": "user_levels",
+          "record": {
+            "table": "user_levels",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "serial",
+                "primary": true
+              },
+              "code": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "회원 등급 코드"
+              },
+              "type_code": {
+                "type": "text",
+                "notNull": true,
+                "references": {
+                  "model": "UserTypeModel",
+                  "column": "code",
+                  "onDelete": "cascade",
+                  "table": "user_types"
+                },
+                "comment": "회원 유형 코드"
+              },
+              "sort_order": {
+                "type": "integer",
+                "notNull": true,
+                "default": 0,
+                "comment": "정렬 순서"
+              },
+              "name": {
+                "type": "text",
+                "notNull": true,
+                "comment": "회원 등급명"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": [
+              {
+                "columns": [
+                  "type_code"
+                ],
+                "name": "idx_user_levels_type_code"
+              }
+            ]
+          }
+        },
+        {
+          "name": "UserModel",
+          "table": "users",
+          "record": {
+            "table": "users",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "bigSerial",
+                "primary": true
+              },
+              "uuid": {
+                "type": "uuid",
+                "notNull": true,
+                "default": {
+                  "raw": "gen_random_uuid()"
+                },
+                "comment": "고유값"
+              },
+              "username": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "로그인 아이디"
+              },
+              "password_hash": {
+                "type": "text",
+                "notNull": true,
+                "comment": "비밀번호 해시"
+              },
+              "type_code": {
+                "type": "text",
+                "notNull": true,
+                "default": "USER",
+                "comment": "회원 유형"
+              },
+              "level_code": {
+                "type": "text",
+                "notNull": true,
+                "default": "lv1",
+                "comment": "회원 등급"
+              },
+              "name": {
+                "type": "text",
+                "notNull": true,
+                "comment": "실명"
+              },
+              "nickname": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "별명"
+              },
+              "email": {
+                "type": "text",
+                "comment": "이메일"
+              },
+              "phone_number": {
+                "type": "text",
+                "comment": "전화번호"
+              },
+              "last_login_at": {
+                "type": "timestamptz",
+                "comment": "마지막 로그인 시간"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": [
+              {
+                "columns": [
+                  "uuid"
+                ],
+                "name": "idx_users_uuid",
+                "unique": true
+              },
+              {
+                "columns": [
+                  "email"
+                ],
+                "name": "idx_users_email"
+              },
+              {
+                "columns": [
+                  "type_code"
+                ],
+                "name": "idx_users_type_code"
+              },
+              {
+                "columns": [
+                  "level_code"
+                ],
+                "name": "idx_users_level_code"
+              }
+            ]
+          }
+        },
+        {
+          "name": "UserTypeModel",
+          "table": "user_types",
+          "record": {
+            "table": "user_types",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "serial",
+                "primary": true
+              },
+              "code": {
+                "type": "text",
+                "notNull": true,
+                "unique": true,
+                "comment": "회원 유형 코드"
+              },
+              "sort_order": {
+                "type": "integer",
+                "notNull": true,
+                "default": 0,
+                "comment": "정렬 순서"
+              },
+              "name": {
+                "type": "text",
+                "notNull": true,
+                "comment": "회원 유형명"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": []
+          }
+        },
+        {
+          "name": "WalletModel",
+          "table": "wallets",
+          "record": {
+            "table": "wallets",
+            "adapter": "primary",
+            "columns": {
+              "id": {
+                "type": "serial",
+                "primary": true
+              },
+              "user_id": {
+                "type": "bigInteger",
+                "notNull": true,
+                "references": {
+                  "model": "UserModel",
+                  "column": "id",
+                  "onDelete": "cascade",
+                  "table": "users"
+                },
+                "comment": "회원 ID"
+              },
+              "balance": {
+                "type": "decimal",
+                "precision": 20,
+                "scale": 4,
+                "notNull": true,
+                "default": 0,
+                "comment": "잔액"
+              },
+              "created_at": {
+                "type": "timestamptz",
+                "notNull": true,
+                "default": {
+                  "raw": "now()"
+                },
+                "comment": "생성 시간"
+              }
+            },
+            "indexes": [
+              {
+                "columns": [
+                  "user_id"
+                ],
+                "name": "idx_wallets_user_id"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  }
+}