@playcraft/cli 0.0.14 → 0.0.17

package/dist/playable/vite-builder.js

@@ -0,0 +1,125 @@
+import { build as viteBuild } from 'vite';
+import fs from 'fs/promises';
+import path from 'path';
+import { ViteConfigBuilder } from './vite/config-builder.js';
+import { PLATFORM_CONFIGS } from './vite/platform-configs.js';
+/**
+ * Vite 构建器 - 使用 Vite 构建 Playable Ads
+ *
+ * 职责：
+ * 1. 验证输入是有效的基础构建
+ * 2. 创建 Vite 配置
+ * 3. 执行 Vite 构建
+ * 4. 验证输出大小
+ * 5. 生成报告
+ */
+export class ViteBuilder {
+    baseBuildDir;
+    options;
+    sizeReport;
+    constructor(baseBuildDir, options) {
+        this.baseBuildDir = baseBuildDir;
+        this.options = options;
+        const platformConfig = PLATFORM_CONFIGS[options.platform];
+        this.sizeReport = {
+            engine: 0,
+            assets: {},
+            total: 0,
+            limit: platformConfig.sizeLimit,
+        };
+    }
+    /**
+     * 执行构建
+     */
+    async build() {
+        // 1. 验证输入
+        await this.validateBaseBuild();
+        // 2. 创建 Vite 配置
+        const configBuilder = new ViteConfigBuilder(this.baseBuildDir, this.options.platform, this.options);
+        const viteConfig = configBuilder.create();
+        // 3. 执行 Vite 构建
+        await viteBuild(viteConfig);
+        // 4. 验证输出大小
+        const outputPath = this.getOutputPath();
+        await this.validateSize(outputPath);
+        // 5. 生成报告
+        this.generateReport(outputPath);
+        return outputPath;
+    }
+    /**
+     * 验证基础构建
+     */
+    async validateBaseBuild() {
+        const requiredFiles = [
+            'index.html',
+            'config.json',
+            '__start__.js',
+        ];
+        const missingFiles = [];
+        for (const file of requiredFiles) {
+            try {
+                await fs.access(path.join(this.baseBuildDir, file));
+            }
+            catch (error) {
+                missingFiles.push(file);
+            }
+        }
+        if (missingFiles.length > 0) {
+            throw new Error(`基础构建产物缺少必需文件: ${missingFiles.join(', ')}\n` +
+                `请确保输入目录包含完整的多文件构建产物。`);
+        }
+    }
+    /**
+     * 获取输出路径
+     */
+    getOutputPath() {
+        const platformConfig = PLATFORM_CONFIGS[this.options.platform];
+        const outputDir = this.options.outputDir || './dist';
+        if (platformConfig.outputFormat === 'zip') {
+            return path.join(outputDir, 'playable.zip');
+        }
+        return path.join(outputDir, platformConfig.outputFileName);
+    }
+    /**
+     * 验证输出大小
+     */
+    async validateSize(outputPath) {
+        try {
+            const stats = await fs.stat(outputPath);
+            this.sizeReport.total = stats.size;
+            this.sizeReport.assets[path.basename(outputPath)] = stats.size;
+            if (stats.size > this.sizeReport.limit) {
+                const sizeMB = (stats.size / 1024 / 1024).toFixed(2);
+                const limitMB = (this.sizeReport.limit / 1024 / 1024).toFixed(2);
+                console.warn(`⚠️  警告: 文件大小 ${sizeMB} MB 超过限制 ${limitMB} MB`);
+            }
+        }
+        catch (error) {
+            console.warn(`警告: 无法读取输出文件: ${outputPath}`);
+        }
+    }
+    /**
+     * 生成报告
+     */
+    generateReport(outputPath) {
+        // 报告已在 validateSize 中生成
+        // 这里可以添加额外的报告逻辑
+    }
+    /**
+     * 获取大小报告
+     */
+    getSizeReport() {
+        return this.sizeReport;
+    }
+    /**
+     * 格式化字节数
+     */
+    formatBytes(bytes) {
+        if (bytes === 0)
+            return '0 Bytes';
+        const k = 1024;
+        const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return Math.round(bytes / Math.pow(k, i) * 100) / 100 + ' ' + sizes[i];
+    }
+}

package/dist/server.js

@@ -1,9 +1,13 @@
 import express from 'express';
 import cors from 'cors';
-export function createServer(config, fsHandler) {
+import path from 'path';
+export function createServer(config, fsHandler, options) {
     const app = express();
-    app.use(cors());
-    app.use(express.json());
+    app.use(cors({
+        origin: true, // reflect request origin
+        credentials: true, // allow credentials (withCredentials)
+    }));
+    app.use(express.json({ limit: '50mb' }));
     // Health check
     app.get('/health', (req, res) => {
         res.json({ status: 'ok', projectId: config.projectId });
@@ -54,10 +58,22 @@ export function createServer(config, fsHandler) {
             return res.status(400).json({ error: 'Missing path parameter' });
         }
         try {
-            const result = await fsHandler.readBinaryFile(filePath);
+            let result = await fsHandler.readBinaryFile(filePath);
+            let actualPath = filePath;
+            // Fallback: if exact path not found and path starts with "assets/",
+            // search recursively in the assets directory for a file with the same name.
+            // Note: findFileRecursive() has built-in caching (5min TTL) and depth limiting (max 10 levels)
+            if (!result.exists && filePath.startsWith('assets/')) {
+                const fileName = path.basename(filePath);
+                const found = await fsHandler.findFileRecursive('assets', fileName);
+                if (found) {
+                    result = await fsHandler.readBinaryFile(found);
+                    actualPath = found;
+                }
+            }
             if (result.exists) {
-                // Set appropriate content type
-                const ext = filePath.split('.').pop()?.toLowerCase();
+                // Set appropriate content type based on the actual file path
+                const ext = actualPath.split('.').pop()?.toLowerCase();
                 const contentType = getContentType(ext || '');
                 res.setHeader('Content-Type', contentType);
                 if (result.size !== undefined) {
@@ -81,6 +97,7 @@ export function createServer(config, fsHandler) {
         }
         try {
             await fsHandler.writeFile(filePath, content ?? '');
+            options?.onFileWritten?.(filePath);
             res.json({ success: true, path: filePath });
         }
         catch (error) {

package/dist/socket.js

@@ -59,8 +59,9 @@ export class SocketServer {
     onConnectionChange;
     constructor(server, config, onConnectionChange) {
         this.config = config;
-        // 注意：必须显式指定 path='/'，避免拦截 /realtime、/messenger 等其他 WebSocket 服务
-        this.wss = new WebSocketServer({ server, path: '/' });
+        // 使用 noServer 模式，由 agent.ts 的统一 upgrade handler 分发 WebSocket 连接
+        // 避免多个 WebSocketServer 在同一个 HTTP server 上的 upgrade 事件冲突
+        this.wss = new WebSocketServer({ noServer: true });
         this.onConnectionChange = onConnectionChange;
         this.wss.on('connection', (ws) => {
             this.clients.set(ws, { patterns: ['**/*'] });
@@ -173,4 +174,8 @@ export class SocketServer {
     getConnectionCount() {
         return this.clients.size;
     }
+    /** 获取内部 WebSocketServer 实例，用于手动 handleUpgrade */
+    getWss() {
+        return this.wss;
+    }
 }

package/dist/watcher.js

@@ -4,6 +4,13 @@ export class Watcher {
     config;
     onChange;
     watcher;
+    /**
+     * 被抑制的文件路径及其过期时间戳。
+     * 当 Editor 通过 HTTP 保存文件时，将文件路径加入此 Map，
+     * Watcher 在窗口期内忽略该文件的变更通知，防止保存→watcher→reload 循环。
+     */
+    suppressedFiles = new Map();
+    static SUPPRESS_WINDOW_MS = 3000; // 3 秒抑制窗口
     constructor(config, onChange) {
         this.config = config;
         this.onChange = onChange;
@@ -24,9 +31,28 @@ export class Watcher {
             .on('unlink', (filePath) => this.handleEvent(filePath, 'delete'));
     }
     handleEvent(filePath, type) {
-        const relativePath = path.relative(this.config.dir, filePath);
+        // 统一使用 / 分隔符，确保 Windows 和 Unix 行为一致
+        const relativePath = path.relative(this.config.dir, filePath).replace(/\\/g, '/');
+        // 检查是否在抑制窗口内
+        const suppressUntil = this.suppressedFiles.get(relativePath);
+        if (suppressUntil && Date.now() < suppressUntil) {
+            // 文件刚被 Editor 保存，忽略 Watcher 回弹
+            return;
+        }
+        // 过期清理
+        if (suppressUntil) {
+            this.suppressedFiles.delete(relativePath);
+        }
         this.onChange(relativePath, type);
     }
+    /**
+     * 抑制指定文件的 Watcher 通知（在窗口期内）。
+     * 应在 Editor 通过 HTTP API 保存文件后调用。
+     */
+    suppressFile(relativePath, durationMs) {
+        const normalizedPath = relativePath.replace(/\\/g, '/');
+        this.suppressedFiles.set(normalizedPath, Date.now() + (durationMs || Watcher.SUPPRESS_WINDOW_MS));
+    }
     close() {
         return this.watcher.close();
     }

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@playcraft/cli",
-  "version": "0.0.14",
+  "version": "0.0.17",
   "private": false,
   "type": "module",
   "bin": {
-    "playcraft": "./dist/index.js"
+    "playcraft": "./dist/index.js",
+    "playcraft-test": "./dist/index.js"
   },
   "files": [
     "dist",
@@ -21,8 +22,8 @@
     "release": "node scripts/release.js"
   },
   "dependencies": {
-    "@playcraft/common": "^0.0.4",
-    "@playcraft/build": "^0.0.11",
+    "@playcraft/common": "^0.0.7",
+    "@playcraft/build": "^0.0.14",
     "chokidar": "^4.0.3",
     "commander": "^13.1.0",
     "cors": "^2.8.6",