@fuzionx/framework 0.1.20 → 0.1.21

package/lib/core/Application.js

@@ -323,8 +323,11 @@ export default class Application {
 
         if (!this._booted) await this.boot();
 
-        // 포트 사용 여부 확인 — 충돌 시 명확한 에러
-        await this._checkPort(port);
+        // 포트 사용 여부 확인 — primary에서만 (워커는 SO_REUSEPORT로 공유)
+        const cluster = await import('node:cluster');
+        if (!cluster.default?.isWorker) {
+            await this._checkPort(port);
+        }
 
         await this.emit('ready');
 

package/lib/helpers/MediaHelper.js

@@ -35,4 +35,50 @@ export default class MediaHelper {
         if (this._bridge?.mediaVideoInfo) return this._bridge.mediaVideoInfo(filePath);
         throw new Error('Video info requires ffprobe + Bridge.');
     }
+
+    /**
+     * 이미지에 워터마크를 합성한다.
+     * @param {string} targetPath - 대상 이미지 경로
+     * @param {string} watermarkPath - 워터마크 이미지 경로
+     * @param {number} [opacity=50] - 불투명도 (0-100)
+     * @param {string} [format] - 출력 포맷 (기본: 원본 확장자)
+     * @param {number} [quality=90] - 출력 품질
+     */
+    applyWatermark(targetPath, watermarkPath, opacity = 50, format, quality = 90) {
+        if (this._bridge?.mediaApplyWatermark) {
+            return this._bridge.mediaApplyWatermark(targetPath, watermarkPath, opacity, format, quality);
+        }
+        throw new Error('Watermark requires Bridge (Rust).');
+    }
+
+    /**
+     * 비디오에서 N초 간격으로 다중 썸네일을 추출한다.
+     * @param {string} inputPath - 비디오 경로
+     * @param {string} outputDir - 출력 디렉토리
+     * @param {number} [interval=5] - 초 간격
+     * @param {number} [width=320] - 썸네일 가로 크기
+     * @param {string} [format='jpeg'] - 포맷
+     * @returns {string[]} 생성된 파일 경로 목록
+     */
+    videoThumbnails(inputPath, outputDir, interval = 5, width = 320, format = 'jpeg') {
+        if (this._bridge?.mediaVideoThumbnails) {
+            return this._bridge.mediaVideoThumbnails(inputPath, outputDir, interval, width, format);
+        }
+        throw new Error('Video thumbnails requires ffmpeg + Bridge.');
+    }
+
+    /**
+     * 썸네일 목록을 스프라이트 시트(그리드)로 합성한다.
+     * @param {string[]} thumbPaths - 썸네일 경로 목록
+     * @param {string} outputPath - 출력 스프라이트 시트 경로
+     * @param {number} [cols=10] - 그리드 열 수
+     * @param {number} [thumbWidth=160] - 각 썸네일 가로
+     * @param {number} [thumbHeight=0] - 각 썸네일 세로 (0=자동)
+     */
+    videoPreviewSheet(thumbPaths, outputPath, cols = 10, thumbWidth = 160, thumbHeight = 0) {
+        if (this._bridge?.mediaVideoPreviewSheet) {
+            return this._bridge.mediaVideoPreviewSheet(thumbPaths, outputPath, cols, thumbWidth, thumbHeight);
+        }
+        throw new Error('Preview sheet requires Bridge (Rust).');
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzionx/framework",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "type": "module",
   "description": "Full-stack MVC framework built on @fuzionx/core — Controller, Service, Model, Middleware, DI, EventBus",
   "main": "index.js",
@@ -34,7 +34,7 @@
     "url": "https://github.com/saytohenry/fuzionx"
   },
   "dependencies": {
-    "@fuzionx/core": "^0.1.20",
+    "@fuzionx/core": "^0.1.21",
     "better-sqlite3": "^12.8.0",
     "knex": "^3.2.5",
     "mongoose": "^9.3.2",