@playcraft/devkit 1.0.31-beta.11 → 1.0.31-beta.14

package/core/constants.js

@@ -1,24 +1,6 @@
 #!/usr/bin/env node
-
-'use strict';
-
-/**
+"use strict";/**
  * 全局常量配置
  * 
  * 集中管理服务端 API 地址、构建参数等常量，方便切换环境。
- */
-
-/** 服务端 API 基础地址（主） */
-const API_BASE_URL = 'http://9.135.99.122';
-
-/** 服务端 API 基础地址（备用），主地址不可用时 fallback */
-const API_BASE_URL_FALLBACK = 'https://wd-act.woa.com';
-
-/** 可试玩广告产物大小上限（Facebook ZIP 与其余 ZIP 渠道一致） */
-const MAX_PLAYABLE_PACKAGE_BYTES = 5 * 1024 * 1024;
-
-module.exports = {
-  API_BASE_URL,
-  API_BASE_URL_FALLBACK,
-  MAX_PLAYABLE_PACKAGE_BYTES,
-};
+ *//** 服务端 API 基础地址（主） */const API_BASE_URL="http://9.135.99.122";/** 服务端 API 基础地址（备用），主地址不可用时 fallback */const API_BASE_URL_FALLBACK="https://wd-act.woa.com";/** 可试玩广告产物大小上限（Facebook ZIP 与其余 ZIP 渠道一致） */const MAX_PLAYABLE_PACKAGE_BYTES=5*1024*1024;module.exports={API_BASE_URL,API_BASE_URL_FALLBACK,MAX_PLAYABLE_PACKAGE_BYTES};

package/core/cos-uploader.js

@@ -1,146 +1,25 @@
 #!/usr/bin/env node
-
-'use strict';
-
-/**
+"use strict";/**
  * COS 上传模块
  * 
  * 功能：上传文件到腾讯云 COS，并刷新 CDN 缓存
- */
-
-const COS = require('cos-nodejs-sdk-v5');
-const fs = require('fs');
-const path = require('path');
-const http = require('http');
-const https = require('https');
-const { API_BASE_URL, API_BASE_URL_FALLBACK } = require('./constants');
-
-/**
+ */const COS=require("cos-nodejs-sdk-v5");const fs=require("fs");const path=require("path");const http=require("http");const https=require("https");const{API_BASE_URL,API_BASE_URL_FALLBACK}=require("./constants");/**
  * 通用 API 请求（自动适配 http/https，支持失败 fallback）
  * @param {string} path - API 路径，如 '/aix/playable/api/cos/credentials'
  * @param {string} method - 请求方法 GET/POST
  * @param {Object|null} postData - POST 请求体（JSON 对象）
  * @returns {Promise<Object>} - 解析后的 JSON 响应
- */
-async function apiRequest(path, method = 'GET', postData = null) {
-  const urls = [
-    `${API_BASE_URL}${path}`,
-    `${API_BASE_URL_FALLBACK}${path}`,
-  ];
-
-  let lastError = null;
-
-  for (const url of urls) {
-    try {
-      const result = await new Promise((resolve, reject) => {
-        const isHttps = url.startsWith('https');
-        const transport = isHttps ? https : http;
-
-        const doRequest = (res) => {
-          if (res.statusCode !== 200) {
-            reject(new Error(`HTTP ${res.statusCode}: ${res.statusMessage}`));
-            return;
-          }
-          let data = '';
-          res.on('data', chunk => data += chunk);
-          res.on('end', () => {
-            try {
-              const result = JSON.parse(data);
-              if (result.code === 'SUCCESS') {
-                resolve(result);
-              } else {
-                reject(new Error(result.message || 'API request failed'));
-              }
-            } catch (error) {
-              reject(new Error(`Failed to parse response: ${error.message}`));
-            }
-          });
-        };
-
-        let req;
-        if (method === 'POST' && postData) {
-          const body = JSON.stringify(postData);
-          req = transport.request(url, {
-            method: 'POST',
-            headers: {
-              'Content-Type': 'application/json',
-              'Content-Length': Buffer.byteLength(body),
-            },
-          }, doRequest);
-          req.write(body);
-        } else {
-          req = transport.get(url, doRequest);
-        }
-
-        req.on('error', reject);
-        req.setTimeout(30000, function () {
-          this.destroy();
-          reject(new Error('Request timeout'));
-        });
-
-        if (method === 'GET') {
-          req.end();
-        } else if (method === 'POST' && !postData) {
-          req.end();
-        }
-      });
-
-      // 成功则直接返回
-      return result;
-    } catch (error) {
-      lastError = error;
-      // 如果还有备用 URL，继续尝试
-      if (url !== urls[urls.length - 1]) {
-        console.warn(`⚠️  主域名请求失败 (${url}), 尝试备用域名...`);
-        continue;
-      }
-    }
-  }
-
-  throw lastError || new Error('All API endpoints failed');
-}
-
-/**
+ */async function apiRequest(path,method="GET",postData=null){const urls=[`${API_BASE_URL}${path}`,`${API_BASE_URL_FALLBACK}${path}`];let lastError=null;for(const url of urls){try{const result=await new Promise((resolve,reject)=>{const isHttps=url.startsWith("https");const transport=isHttps?https:http;const doRequest=res=>{if(res.statusCode!==200){reject(new Error(`HTTP ${res.statusCode}: ${res.statusMessage}`));return}let data="";res.on("data",chunk=>data+=chunk);res.on("end",()=>{try{const result=JSON.parse(data);if(result.code==="SUCCESS"){resolve(result)}else{reject(new Error(result.message||"API request failed"))}}catch(error){reject(new Error(`Failed to parse response: ${error.message}`))}})};let req;if(method==="POST"&&postData){const body=JSON.stringify(postData);req=transport.request(url,{method:"POST",headers:{"Content-Type":"application/json","Content-Length":Buffer.byteLength(body)}},doRequest);req.write(body)}else{req=transport.get(url,doRequest)}req.on("error",reject);req.setTimeout(30000,function(){this.destroy();reject(new Error("Request timeout"))});if(method==="GET"){req.end()}else if(method==="POST"&&!postData){req.end()}});// 成功则直接返回
+return result}catch(error){lastError=error;// 如果还有备用 URL，继续尝试
+if(url!==urls[urls.length-1]){console.warn(`⚠️  主域名请求失败 (${url}), 尝试备用域名...`);continue}}}throw lastError||new Error("All API endpoints failed")}/**
  * 从远程 API 获取临时凭证（支持主/备域名 fallback）
- */
-async function fetchTemporaryCredentials() {
-  const result = await apiRequest('/aix/playable/api/cos/credentials');
-  return result.data;
-}
-
-/**
+ */async function fetchTemporaryCredentials(){const result=await apiRequest("/aix/playable/api/cos/credentials");return result.data}/**
  * 创建 COS 客户端（使用临时凭证）
  * @param {Object} cosConfig - COS 配置
  * @param {Object} credentials - 已获取的临时凭证（可选，避免重复请求）
- */
-async function createCOSClient(cosConfig, credentials = null) {
-  // 如果配置中提供了 SecretId 和 SecretKey，使用传统方式
-  if (cosConfig && cosConfig.SecretId && cosConfig.SecretKey) {
-    return new COS({
-      SecretId: cosConfig.SecretId,
-      SecretKey: cosConfig.SecretKey,
-    });
-  }
-  
-  // 使用已传入的凭证，或重新获取
-  if (!credentials) {
-    credentials = await fetchTemporaryCredentials();
-  }
-  
-  return new COS({
-    getAuthorization: (options, callback) => {
-      callback({
-        TmpSecretId: credentials.credentials.tmpSecretId,
-        TmpSecretKey: credentials.credentials.tmpSecretKey,
-        SecurityToken: credentials.credentials.sessionToken,
-        StartTime: credentials.startTime,
-        ExpiredTime: credentials.expiredTime,
-      });
-    },
-  });
-}
-
-/**
+ */async function createCOSClient(cosConfig,credentials=null){// 如果配置中提供了 SecretId 和 SecretKey，使用传统方式
+if(cosConfig&&cosConfig.SecretId&&cosConfig.SecretKey){return new COS({SecretId:cosConfig.SecretId,SecretKey:cosConfig.SecretKey})}// 使用已传入的凭证，或重新获取
+if(!credentials){credentials=await fetchTemporaryCredentials()}return new COS({getAuthorization:(options,callback)=>{callback({TmpSecretId:credentials.credentials.tmpSecretId,TmpSecretKey:credentials.credentials.tmpSecretKey,SecurityToken:credentials.credentials.sessionToken,StartTime:credentials.startTime,ExpiredTime:credentials.expiredTime})}})}/**
  * 刷新 CDN 缓存
  * 通过服务端 API 代理执行（STS 临时凭证无法携带 CDN 权限，需由服务端使用主账号凭证刷新）
  * 
@@ -148,49 +27,9 @@ async function createCOSClient(cosConfig, credentials = null) {
  * @param {Array<string>} urls - 需要刷新的 URL 列表
  * @param {Object} credentials - 未使用，保留参数兼容性
  * @returns {Promise<void>}
- */
-async function purgeCDNCache(cosConfig, urls, credentials = null) {
-  if (!urls || urls.length === 0) {
-    return;
-  }
-
-  const area = cosConfig?.CdnArea || 'overseas';
-
-  // 如果配置中有 SecretId/SecretKey，本地直接刷新
-  if (cosConfig && cosConfig.SecretId && cosConfig.SecretKey) {
-    try {
-      const tencentcloud = require('tencentcloud-sdk-nodejs-cdn');
-      const client = new tencentcloud.cdn.v20180606.Client({
-        credential: { secretId: cosConfig.SecretId, secretKey: cosConfig.SecretKey },
-        region: '',
-        profile: { httpProfile: { endpoint: 'cdn.tencentcloudapi.com' } },
-      });
-      const batchSize = 1000;
-      for (let i = 0; i < urls.length; i += batchSize) {
-        const batch = urls.slice(i, i + batchSize);
-        await client.PurgeUrlsCache({ Urls: batch, Area: area });
-        console.log(`✓ CDN 缓存已刷新 ${batch.length} 个 URL (区域: ${area})`);
-      }
-    } catch (error) {
-      if (error.code === 'MODULE_NOT_FOUND') {
-        console.warn('⚠️  未安装 tencentcloud-sdk-nodejs-cdn，跳过 CDN 刷新');
-      } else {
-        throw error;
-      }
-    }
-    return;
-  }
-
-  // 否则通过服务端 API 代理刷新（支持主/备域名 fallback）
-  try {
-    await apiRequest('/aix/playable/api/cdn/purge', 'POST', { urls, area });
-    console.log(`✓ CDN 缓存已刷新 ${urls.length} 个 URL (区域: ${area})`);
-  } catch (error) {
-    throw new Error(`CDN purge failed: ${error.message}`);
-  }
-}
-
-/**
+ */async function purgeCDNCache(cosConfig,urls,credentials=null){if(!urls||urls.length===0){return}const area=(cosConfig===null||cosConfig===void 0?void 0:cosConfig.CdnArea)||"overseas";// 如果配置中有 SecretId/SecretKey，本地直接刷新
+if(cosConfig&&cosConfig.SecretId&&cosConfig.SecretKey){try{const tencentcloud=require("tencentcloud-sdk-nodejs-cdn");const client=new tencentcloud.cdn.v20180606.Client({credential:{secretId:cosConfig.SecretId,secretKey:cosConfig.SecretKey},region:"",profile:{httpProfile:{endpoint:"cdn.tencentcloudapi.com"}}});const batchSize=1000;for(let i=0;i<urls.length;i+=batchSize){const batch=urls.slice(i,i+batchSize);await client.PurgeUrlsCache({Urls:batch,Area:area});console.log(`✓ CDN 缓存已刷新 ${batch.length} 个 URL (区域: ${area})`)}}catch(error){if(error.code==="MODULE_NOT_FOUND"){console.warn("\u26A0\uFE0F  \u672A\u5B89\u88C5 tencentcloud-sdk-nodejs-cdn\uFF0C\u8DF3\u8FC7 CDN \u5237\u65B0")}else{throw error}}return}// 否则通过服务端 API 代理刷新（支持主/备域名 fallback）
+try{await apiRequest("/aix/playable/api/cdn/purge","POST",{urls,area});console.log(`✓ CDN 缓存已刷新 ${urls.length} 个 URL (区域: ${area})`)}catch(error){throw new Error(`CDN purge failed: ${error.message}`)}}/**
  * 上传单个文件到 COS
  * 
  * @param {Object} cosConfig - COS 配置
@@ -198,58 +37,12 @@ async function purgeCDNCache(cosConfig, urls, credentials = null) {
  * @param {string} cosKey - COS 对象键（远程路径）
  * @param {Object} credentials - 可选的凭证对象
  * @returns {Promise<string>} - 上传成功返回访问链接
- */
-async function uploadFileToCOS(cosConfig, filePath, cosKey, credentials = null) {
-  if (!fs.existsSync(filePath)) {
-    throw new Error(`文件不存在: ${filePath}`);
-  }
-
-  // 获取临时凭证和配置信息
-  let bucket, region, cdnDomain;
-  
-  if (cosConfig && cosConfig.Bucket && cosConfig.Region) {
-    // 使用配置文件中的信息
-    bucket = cosConfig.Bucket;
-    region = cosConfig.Region;
-    cdnDomain = cosConfig.CdnDomain || 'static.aix.intlgame.com';
-  } else {
-    // 从临时凭证 API 获取配置（优先使用传入的凭证，否则重新获取）
-    if (!credentials) {
-      credentials = await fetchTemporaryCredentials();
-    }
-    bucket = credentials.bucket;
-    region = credentials.region;
-    cdnDomain = 'static.aix.intlgame.com';
-  }
-
-  const cos = await createCOSClient(cosConfig || null, credentials);
-
-  return new Promise((resolve, reject) => {
-    cos.putObject(
-      {
-        Bucket: bucket,
-        Region: region,
-        Key: cosKey,
-        Body: fs.createReadStream(filePath),
-      },
-      (err, data) => {
-        if (err) {
-          reject(new Error(`上传失败: ${err.message}`));
-        } else {
-          // 生成访问链接
-          // 对路径的每个部分分别进行 URL 编码
-          const pathParts = cosKey.split('/');
-          const encodedPath = pathParts.map(part => encodeURIComponent(part)).join('/');
-          
-          const url = `https://${cdnDomain}/${encodedPath}`;
-          resolve(url);
-        }
-      }
-    );
-  });
-}
-
-/**
+ */async function uploadFileToCOS(cosConfig,filePath,cosKey,credentials=null){if(!fs.existsSync(filePath)){throw new Error(`文件不存在: ${filePath}`)}// 获取临时凭证和配置信息
+let bucket,region,cdnDomain;if(cosConfig&&cosConfig.Bucket&&cosConfig.Region){// 使用配置文件中的信息
+bucket=cosConfig.Bucket;region=cosConfig.Region;cdnDomain=cosConfig.CdnDomain||"static.aix.intlgame.com"}else{// 从临时凭证 API 获取配置（优先使用传入的凭证，否则重新获取）
+if(!credentials){credentials=await fetchTemporaryCredentials()}bucket=credentials.bucket;region=credentials.region;cdnDomain="static.aix.intlgame.com"}const cos=await createCOSClient(cosConfig||null,credentials);return new Promise((resolve,reject)=>{cos.putObject({Bucket:bucket,Region:region,Key:cosKey,Body:fs.createReadStream(filePath)},(err,data)=>{if(err){reject(new Error(`上传失败: ${err.message}`))}else{// 生成访问链接
+// 对路径的每个部分分别进行 URL 编码
+const pathParts=cosKey.split("/");const encodedPath=pathParts.map(part=>encodeURIComponent(part)).join("/");const url=`https://${cdnDomain}/${encodedPath}`;resolve(url)}})})}/**
  * 上传目录下的所有文件到 COS
  * 
  * @param {Object} cosConfig - COS 配置
@@ -258,67 +51,8 @@ async function uploadFileToCOS(cosConfig, filePath, cosKey, credentials = null)
  * @param {Object} credentials - 可选的凭证对象
  * @param {(fileName: string, filePath: string) => boolean} [fileFilter] - 可选文件过滤器，返回 false 则跳过
  * @returns {Promise<Array>} - 上传成功返回文件列表
- */
-async function uploadDirectoryToCOS(cosConfig, localDir, cosPrefix, credentials = null, fileFilter = null) {
-  if (!fs.existsSync(localDir)) {
-    throw new Error(`目录不存在: ${localDir}`);
-  }
-
-  // 如果没有传入凭证且没有配置，获取一次凭证用于所有文件上传
-  if (!credentials && (!cosConfig || !cosConfig.Bucket || !cosConfig.Region)) {
-    try {
-      credentials = await fetchTemporaryCredentials();
-      console.log('✓ 获取临时凭证成功');
-    } catch (error) {
-      throw new Error(`获取临时凭证失败: ${error.message}`);
-    }
-  }
-
-  const files = fs.readdirSync(localDir);
-  const results = [];
-  const uploadedUrls = [];
-
-  for (const file of files) {
-    const filePath = path.join(localDir, file);
-    const stat = fs.statSync(filePath);
-
-    if (stat.isFile()) {
-      if (typeof fileFilter === 'function' && !fileFilter(file, filePath)) {
-        continue;
-      }
-      // 去掉文件名中的 -preview 或 _preview 后缀
-      let cleanFileName = file;
-      cleanFileName = cleanFileName.replace(/-preview\./i, '.');
-      cleanFileName = cleanFileName.replace(/_preview\./i, '.');
-      
-      const cosKey = cosPrefix ? `${cosPrefix}/${cleanFileName}` : cleanFileName;
-      // 传入凭证，避免重复获取
-      const url = await uploadFileToCOS(cosConfig, filePath, cosKey, credentials);
-      results.push({
-        file: cleanFileName,
-        url,
-      });
-      uploadedUrls.push(url);
-    }
-  }
-
-  // 上传完成后刷新 CDN 缓存，传入凭证
-  if (uploadedUrls.length > 0) {
-    try {
-      await purgeCDNCache(cosConfig, uploadedUrls, credentials);
-      console.log(`✓ CDN 缓存刷新成功 (${uploadedUrls.length} 个文件)`);
-    } catch (error) {
-      console.warn(`⚠️  CDN 刷新失败: ${error.message}`);
-    }
-  }
-
-  return results;
-}
-
-module.exports = {
-  fetchTemporaryCredentials,
-  createCOSClient,
-  uploadFileToCOS,
-  uploadDirectoryToCOS,
-  purgeCDNCache,
-};
+ */async function uploadDirectoryToCOS(cosConfig,localDir,cosPrefix,credentials=null,fileFilter=null){if(!fs.existsSync(localDir)){throw new Error(`目录不存在: ${localDir}`)}// 如果没有传入凭证且没有配置，获取一次凭证用于所有文件上传
+if(!credentials&&(!cosConfig||!cosConfig.Bucket||!cosConfig.Region)){try{credentials=await fetchTemporaryCredentials();console.log("\u2713 \u83B7\u53D6\u4E34\u65F6\u51ED\u8BC1\u6210\u529F")}catch(error){throw new Error(`获取临时凭证失败: ${error.message}`)}}const files=fs.readdirSync(localDir);const results=[];const uploadedUrls=[];for(const file of files){const filePath=path.join(localDir,file);const stat=fs.statSync(filePath);if(stat.isFile()){if(typeof fileFilter==="function"&&!fileFilter(file,filePath)){continue}// 去掉文件名中的 -preview 或 _preview 后缀
+let cleanFileName=file;cleanFileName=cleanFileName.replace(/-preview\./i,".");cleanFileName=cleanFileName.replace(/_preview\./i,".");const cosKey=cosPrefix?`${cosPrefix}/${cleanFileName}`:cleanFileName;// 传入凭证，避免重复获取
+const url=await uploadFileToCOS(cosConfig,filePath,cosKey,credentials);results.push({file:cleanFileName,url});uploadedUrls.push(url)}}// 上传完成后刷新 CDN 缓存，传入凭证
+if(uploadedUrls.length>0){try{await purgeCDNCache(cosConfig,uploadedUrls,credentials);console.log(`✓ CDN 缓存刷新成功 (${uploadedUrls.length} 个文件)`)}catch(error){console.warn(`⚠️  CDN 刷新失败: ${error.message}`)}}return results}module.exports={fetchTemporaryCredentials,createCOSClient,uploadFileToCOS,uploadDirectoryToCOS,purgeCDNCache};

package/core/engines/cocos/adapter-vfs-path.test.js

@@ -0,0 +1 @@
+"use strict";const{describe,it}=require("node:test");const assert=require("node:assert/strict");function stripUrl(url){url=String(url||"").trim().split("#")[0].split("?")[0];if(!url)return"";try{if(/^[a-zA-Z][a-zA-Z\d+\-.]*:/.test(url)){const parsed=new URL(url,"https://playable.local/");if(parsed.protocol==="blob:"||parsed.protocol==="data:")return"";url=decodeURIComponent(parsed.pathname||"")}}catch(err){}url=url.replace(/^\/+/,"");const parts=[];url.split("/").forEach(part=>{if(!part||part===".")return;if(part===".."){if(parts.length)parts.pop();return}parts.push(part)});return parts.join("/")}function bestKey(url,target){if(!url||!target)return null;const raw=String(url).split("#")[0].split("?")[0];const stripped=stripUrl(url);if(target[raw])return raw;if(stripped&&target[stripped])return stripped;let best=null;function consider(candidate){if(!candidate||candidate.length<3)return;for(const key in target){if(candidate===key||candidate.endsWith("/"+key)){if(!best||key.length>best.length)best=key}}}consider(stripped);consider(raw);return best}describe("adapter VFS path lookup",()=>{const js={"cocos-js/cc.js":"engine","assets/main/index.js":"game","src/import-map.json":"{\"imports\":{\"cc\":\"./../cocos-js/cc.js\"}}"};it("maps Facebook and Liftoff CDN URLs to the VFS key without changing System ids",()=>{assert.equal(bestKey("https://www.facebook.com/developer/tools/cocos-js/cc.js",js),"cocos-js/cc.js");assert.equal(bestKey("https://cdn.liftoff-creatives.io/tmp/32db3a48-516d-41fb-8508-d1db75caca7e/cocos-js/cc.js",js),"cocos-js/cc.js")});it("maps import-map relative targets after collapsing ..",()=>{assert.equal(bestKey("./../cocos-js/cc.js",js),"cocos-js/cc.js")});it("does not map a short basename onto a different index.js",()=>{assert.equal(bestKey("./dist/index.js",js),null);assert.equal(bestKey("https://example.com/foo/dist/index.js",js),null)});it("resolves the import-map specifier cc to its file target",()=>{const imports=JSON.parse(js["src/import-map.json"]).imports;assert.equal(imports.cc,"./../cocos-js/cc.js");assert.equal(bestKey(imports.cc,js),"cocos-js/cc.js")})});

package/core/engines/cocos/clean-cache.js

@@ -1,188 +1,14 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-/** Overlay of /opt/cocos-cli. Not a script cache; recreating it on Linux is expensive. */
-const KEEP_TEMP_DIRS = new Set(['cocos-cli']);
-
-/** Preview merge lives here; wiping it breaks npm run dev until re-bundle (many UUID .json requests). */
-const PREVIEW_CACHE_RELS = [
-  'temp/programming/preview',
-  'temp/programming/packer-driver/targets/preview',
-];
-
-/** Other temp/* dirs safe to drop before engine build. */
-const TEMP_CACHE_DIRS = new Set([
-  'asset-db',
-  'builder',
-  'declarations',
-  'logs',
-  'writablePath',
-]);
-
-/** Cocos packer-driver / asset-db recreate these immediately after a clean. */
-const WRITABLE_WORKDIR_RELS = [
-  'library',
-  'temp',
-  'temp/programming',
-  'temp/programming/packer-driver',
-  'temp/programming/packer-driver/logs',
-  'temp/builder',
-  'build',
-];
-
-function exists(p) {
-  try {
-    return Boolean(p) && fs.existsSync(p);
-  } catch {
-    return false;
-  }
-}
-
-function chmodTreeWritable(dir) {
-  try {
-    const st = fs.lstatSync(dir);
-    if (st.isSymbolicLink()) return;
-    fs.chmodSync(dir, st.mode | 0o200);
-    if (!st.isDirectory()) return;
-    for (const name of fs.readdirSync(dir)) {
-      chmodTreeWritable(path.join(dir, name));
-    }
-  } catch {
-    // best-effort; rmSync may still fail and we want that error
-  }
-}
-
-function rmTree(dir) {
-  if (!exists(dir)) return false;
-  chmodTreeWritable(dir);
-  fs.rmSync(dir, { recursive: true, force: true });
-  return true;
-}
-
-/**
+"use strict";const fs=require("fs");const path=require("path");/** Overlay of /opt/cocos-cli. Not a script cache; recreating it on Linux is expensive. */const KEEP_TEMP_DIRS=new Set(["cocos-cli"]);/** Preview merge lives here; wiping it breaks npm run dev until re-bundle (many UUID .json requests). */const PREVIEW_CACHE_RELS=["temp/programming/preview","temp/programming/packer-driver/targets/preview"];/** Other temp/* dirs safe to drop before engine build. */const TEMP_CACHE_DIRS=new Set(["asset-db","builder","declarations","logs","writablePath"]);/** Cocos packer-driver / asset-db recreate these immediately after a clean. */const WRITABLE_WORKDIR_RELS=["library","temp","temp/programming","temp/programming/packer-driver","temp/programming/packer-driver/logs","temp/builder","build"];function exists(p){try{return Boolean(p)&&fs.existsSync(p)}catch{return false}}function chmodTreeWritable(dir){try{const st=fs.lstatSync(dir);if(st.isSymbolicLink())return;fs.chmodSync(dir,st.mode|128);if(!st.isDirectory())return;for(const name of fs.readdirSync(dir)){chmodTreeWritable(path.join(dir,name))}}catch{// best-effort; rmSync may still fail and we want that error
+}}function rmTree(dir){if(!exists(dir))return false;chmodTreeWritable(dir);fs.rmSync(dir,{recursive:true,force:true});return true}/**
  * Drop Creator / cocos-cli project caches so packer-driver does not reuse
  * import-map + chunks that still point at another machine's paths.
  *
  * Keeps `temp/cocos-cli` (writable CLI overlay) unless keepCliOverlay is false.
  *
  * @returns {string[]} relative paths that were removed
- */
-function shouldWipePreviewCaches(options = {}, env = process.env) {
-  if (options.cleanPreviewCache === true) return true;
-  if (options.cleanPreviewCache === false) return false;
-  return env.PLAYABLE_CLEAN_PREVIEW_CACHE === '1';
-}
-
-function cleanProgrammingBuildCaches(projectRoot, removed, wipePreview) {
-  const programming = path.join(projectRoot, 'temp', 'programming');
-  if (!exists(programming)) return;
-
-  if (wipePreview) {
-    for (const rel of PREVIEW_CACHE_RELS) {
-      if (rmTree(path.join(projectRoot, rel))) removed.push(rel);
-    }
-    if (rmTree(programming)) {
-      removed.push('temp/programming');
-      return;
-    }
-  }
-
-  const editor = path.join(programming, 'packer-driver', 'targets', 'editor');
-  if (rmTree(editor)) removed.push('temp/programming/packer-driver/targets/editor');
-
-  const logs = path.join(programming, 'packer-driver', 'logs');
-  if (rmTree(logs)) removed.push('temp/programming/packer-driver/logs');
-}
-
-function cleanCocosProjectCaches(projectRoot, options = {}) {
-  const keepOverlay = options.keepCliOverlay !== false;
-  const wipePreview = shouldWipePreviewCaches(options, process.env);
-  const removed = [];
-
-  const library = path.join(projectRoot, 'library');
-  if (rmTree(library)) removed.push('library');
-
-  const tempRoot = path.join(projectRoot, 'temp');
-  if (!exists(tempRoot)) return removed;
-
-  if (!keepOverlay) {
-    if (rmTree(tempRoot)) removed.push('temp');
-    return removed;
-  }
-
-  for (const name of fs.readdirSync(tempRoot)) {
-    if (KEEP_TEMP_DIRS.has(name)) continue;
-    if (name === 'programming') {
-      cleanProgrammingBuildCaches(projectRoot, removed, wipePreview);
-      continue;
-    }
-    if (TEMP_CACHE_DIRS.has(name) && rmTree(path.join(tempRoot, name))) {
-      removed.push(`temp/${name}`);
-    }
-  }
-  return removed;
-}
-
-function ensureDir(dir) {
-  try {
-    const st = fs.lstatSync(dir);
-    if (st.isSymbolicLink() || !st.isDirectory()) {
-      fs.rmSync(dir, { recursive: true, force: true });
-    }
-  } catch (err) {
-    if (err.code !== 'ENOENT') throw err;
-  }
-  fs.mkdirSync(dir, { recursive: true, mode: 0o777 });
-  try {
-    fs.chmodSync(dir, 0o777);
-  } catch {
-    // chmod may fail on some mounts; mkdir succeeding is enough if we own the dir.
-  }
-}
-
-/**
+ */function shouldWipePreviewCaches(options={},env=process.env){if(options.cleanPreviewCache===true)return true;if(options.cleanPreviewCache===false)return false;return env.PLAYABLE_CLEAN_PREVIEW_CACHE==="1"}function cleanProgrammingBuildCaches(projectRoot,removed,wipePreview){const programming=path.join(projectRoot,"temp","programming");if(!exists(programming))return;if(wipePreview){for(const rel of PREVIEW_CACHE_RELS){if(rmTree(path.join(projectRoot,rel)))removed.push(rel)}if(rmTree(programming)){removed.push("temp/programming");return}}const editor=path.join(programming,"packer-driver","targets","editor");if(rmTree(editor))removed.push("temp/programming/packer-driver/targets/editor");const logs=path.join(programming,"packer-driver","logs");if(rmTree(logs))removed.push("temp/programming/packer-driver/logs")}function cleanCocosProjectCaches(projectRoot,options={}){const keepOverlay=options.keepCliOverlay!==false;const wipePreview=shouldWipePreviewCaches(options,process.env);const removed=[];const library=path.join(projectRoot,"library");if(rmTree(library))removed.push("library");const tempRoot=path.join(projectRoot,"temp");if(!exists(tempRoot))return removed;if(!keepOverlay){if(rmTree(tempRoot))removed.push("temp");return removed}for(const name of fs.readdirSync(tempRoot)){if(KEEP_TEMP_DIRS.has(name))continue;if(name==="programming"){cleanProgrammingBuildCaches(projectRoot,removed,wipePreview);continue}if(TEMP_CACHE_DIRS.has(name)&&rmTree(path.join(tempRoot,name))){removed.push(`temp/${name}`)}}return removed}function ensureDir(dir){try{const st=fs.lstatSync(dir);if(st.isSymbolicLink()||!st.isDirectory()){fs.rmSync(dir,{recursive:true,force:true})}}catch(err){if(err.code!=="ENOENT")throw err}fs.mkdirSync(dir,{recursive:true,mode:511});try{fs.chmodSync(dir,511)}catch{// chmod may fail on some mounts; mkdir succeeding is enough if we own the dir.
+}}/**
  * Recreate the dirs cocos-cli writes on startup (winston logs, library).
  * A leftover read-only `temp/programming` from git / a previous root-owned
  * overlay makes `mkdir logs` throw EACCES.
- */
-function ensureWritableCocosWorkdirs(projectRoot) {
-  const created = [];
-  for (const rel of WRITABLE_WORKDIR_RELS) {
-    const dir = path.join(projectRoot, rel);
-    ensureDir(dir);
-    created.push(rel);
-  }
-  const probe = path.join(projectRoot, 'temp', 'programming', 'packer-driver', 'logs', `.write-probe-${process.pid}`);
-  try {
-    fs.writeFileSync(probe, 'ok');
-    fs.unlinkSync(probe);
-  } catch (err) {
-    throw new Error(
-      `[cocos] ${path.join('temp', 'programming', 'packer-driver', 'logs')} is not writable (${err.code || err.message}). `
-      + 'In the sandbox image, chown the remix project to the build user and chmod u+rwX temp library build. '
-      + 'Do not chmod /opt/cocos-cli.'
-    );
-  }
-  return created;
-}
-
-function shouldCleanCocosCache(buildOptions = {}, env = process.env) {
-  if (env.PLAYABLE_KEEP_COCOS_CACHE === '1') return false;
-  if (env.PLAYABLE_CLEAN_COCOS_CACHE === '1') return true;
-  const cocos = buildOptions.cocos || {};
-  if (cocos.cleanCache === false) return false;
-  if (cocos.cleanCache === true) return true;
-  return Boolean(buildOptions.cleanCocosCache);
-}
-
-module.exports = {
-  KEEP_TEMP_DIRS,
-  PREVIEW_CACHE_RELS,
-  WRITABLE_WORKDIR_RELS,
-  cleanCocosProjectCaches,
-  ensureWritableCocosWorkdirs,
-  shouldCleanCocosCache,
-  shouldWipePreviewCaches,
-};
+ */function ensureWritableCocosWorkdirs(projectRoot){const created=[];for(const rel of WRITABLE_WORKDIR_RELS){const dir=path.join(projectRoot,rel);ensureDir(dir);created.push(rel)}const probe=path.join(projectRoot,"temp","programming","packer-driver","logs",`.write-probe-${process.pid}`);try{fs.writeFileSync(probe,"ok");fs.unlinkSync(probe)}catch(err){throw new Error(`[cocos] ${path.join("temp","programming","packer-driver","logs")} is not writable (${err.code||err.message}). `+"In the sandbox image, chown the remix project to the build user and chmod u+rwX temp library build. "+"Do not chmod /opt/cocos-cli.")}return created}function shouldCleanCocosCache(buildOptions={},env=process.env){if(env.PLAYABLE_KEEP_COCOS_CACHE==="1")return false;if(env.PLAYABLE_CLEAN_COCOS_CACHE==="1")return true;const cocos=buildOptions.cocos||{};if(cocos.cleanCache===false)return false;if(cocos.cleanCache===true)return true;return Boolean(buildOptions.cleanCocosCache)}module.exports={KEEP_TEMP_DIRS,PREVIEW_CACHE_RELS,WRITABLE_WORKDIR_RELS,cleanCocosProjectCaches,ensureWritableCocosWorkdirs,shouldCleanCocosCache,shouldWipePreviewCaches};

package/core/engines/cocos/clean-cache.test.js

@@ -1,75 +1 @@
-'use strict';
-
-const { describe, it, afterEach } = require('node:test');
-const assert = require('node:assert/strict');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { cleanCocosProjectCaches, ensureWritableCocosWorkdirs, shouldCleanCocosCache } = require('./clean-cache.js');
-
-function writeFile(file, body) {
-  fs.mkdirSync(path.dirname(file), { recursive: true });
-  fs.writeFileSync(file, body);
-}
-
-describe('cleanCocosProjectCaches', () => {
-  let root;
-
-  afterEach(() => {
-    if (root && fs.existsSync(root)) fs.rmSync(root, { recursive: true, force: true });
-  });
-
-  it('removes editor build cache but keeps preview merge + cli overlay', () => {
-    root = fs.mkdtempSync(path.join(os.tmpdir(), 'cocos-clean-cache-'));
-    writeFile(path.join(root, 'library', 'uuid-to-mtime.json'), '{}');
-    writeFile(path.join(root, 'temp', 'programming', 'packer-driver', 'targets', 'editor', 'import-map.json'), '{}');
-    writeFile(path.join(root, 'temp', 'programming', 'packer-driver', 'targets', 'preview', 'chunks', 'playcraft-bundle.js'), 'bundle');
-    writeFile(path.join(root, 'temp', 'programming', 'preview', 'systemjs', 'playcraft-json-pack.json'), '{}');
-    writeFile(path.join(root, 'temp', 'builder', 'log.txt'), 'x');
-    writeFile(path.join(root, 'temp', 'cocos-cli', 'bin', 'cocos'), '#!/usr/bin/env node\n');
-
-    const removed = cleanCocosProjectCaches(root);
-    assert.deepEqual(
-      new Set(removed),
-      new Set(['library', 'temp/programming/packer-driver/targets/editor', 'temp/builder']),
-    );
-    assert.equal(fs.existsSync(path.join(root, 'library')), false);
-    assert.equal(fs.existsSync(path.join(root, 'temp', 'programming', 'packer-driver', 'targets', 'editor')), false);
-    assert.equal(
-      fs.existsSync(path.join(root, 'temp', 'programming', 'packer-driver', 'targets', 'preview', 'chunks', 'playcraft-bundle.js')),
-      true,
-    );
-    assert.equal(fs.existsSync(path.join(root, 'temp', 'cocos-cli', 'bin', 'cocos')), true);
-  });
-
-  it('replaces a leftover programming dir with writable packer logs', () => {
-    root = fs.mkdtempSync(path.join(os.tmpdir(), 'cocos-clean-cache-'));
-    writeFile(path.join(root, 'temp', 'programming', 'packer-driver', 'stale.txt'), 'old');
-    fs.chmodSync(path.join(root, 'temp', 'programming', 'packer-driver'), 0o555);
-
-    cleanCocosProjectCaches(root);
-    ensureWritableCocosWorkdirs(root);
-
-    const logs = path.join(root, 'temp', 'programming', 'packer-driver', 'logs');
-    const probe = path.join(logs, 'ok.txt');
-    fs.writeFileSync(probe, '1');
-    assert.equal(fs.readFileSync(probe, 'utf8'), '1');
-  });
-
-  it('can wipe the overlay when keepCliOverlay is false', () => {
-    root = fs.mkdtempSync(path.join(os.tmpdir(), 'cocos-clean-cache-'));
-    writeFile(path.join(root, 'temp', 'cocos-cli', 'bin', 'cocos'), 'ok');
-    const removed = cleanCocosProjectCaches(root, { keepCliOverlay: false });
-    assert.deepEqual(removed, ['temp']);
-    assert.equal(fs.existsSync(path.join(root, 'temp')), false);
-  });
-});
-
-describe('shouldCleanCocosCache', () => {
-  it('defaults off, env and cocos.cleanCache win', () => {
-    assert.equal(shouldCleanCocosCache({}, {}), false);
-    assert.equal(shouldCleanCocosCache({ cocos: { cleanCache: true } }, {}), true);
-    assert.equal(shouldCleanCocosCache({ cocos: { cleanCache: true } }, { PLAYABLE_KEEP_COCOS_CACHE: '1' }), false);
-    assert.equal(shouldCleanCocosCache({ cocos: { cleanCache: false } }, { PLAYABLE_CLEAN_COCOS_CACHE: '1' }), true);
-  });
-});
+"use strict";const{describe,it,afterEach}=require("node:test");const assert=require("node:assert/strict");const fs=require("fs");const os=require("os");const path=require("path");const{cleanCocosProjectCaches,ensureWritableCocosWorkdirs,shouldCleanCocosCache}=require("./clean-cache.js");function writeFile(file,body){fs.mkdirSync(path.dirname(file),{recursive:true});fs.writeFileSync(file,body)}describe("cleanCocosProjectCaches",()=>{let root;afterEach(()=>{if(root&&fs.existsSync(root))fs.rmSync(root,{recursive:true,force:true})});it("removes editor build cache but keeps preview merge + cli overlay",()=>{root=fs.mkdtempSync(path.join(os.tmpdir(),"cocos-clean-cache-"));writeFile(path.join(root,"library","uuid-to-mtime.json"),"{}");writeFile(path.join(root,"temp","programming","packer-driver","targets","editor","import-map.json"),"{}");writeFile(path.join(root,"temp","programming","packer-driver","targets","preview","chunks","playcraft-bundle.js"),"bundle");writeFile(path.join(root,"temp","programming","preview","systemjs","playcraft-json-pack.json"),"{}");writeFile(path.join(root,"temp","builder","log.txt"),"x");writeFile(path.join(root,"temp","cocos-cli","bin","cocos"),"#!/usr/bin/env node\n");const removed=cleanCocosProjectCaches(root);assert.deepEqual(new Set(removed),new Set(["library","temp/programming/packer-driver/targets/editor","temp/builder"]));assert.equal(fs.existsSync(path.join(root,"library")),false);assert.equal(fs.existsSync(path.join(root,"temp","programming","packer-driver","targets","editor")),false);assert.equal(fs.existsSync(path.join(root,"temp","programming","packer-driver","targets","preview","chunks","playcraft-bundle.js")),true);assert.equal(fs.existsSync(path.join(root,"temp","cocos-cli","bin","cocos")),true)});it("replaces a leftover programming dir with writable packer logs",()=>{root=fs.mkdtempSync(path.join(os.tmpdir(),"cocos-clean-cache-"));writeFile(path.join(root,"temp","programming","packer-driver","stale.txt"),"old");fs.chmodSync(path.join(root,"temp","programming","packer-driver"),365);cleanCocosProjectCaches(root);ensureWritableCocosWorkdirs(root);const logs=path.join(root,"temp","programming","packer-driver","logs");const probe=path.join(logs,"ok.txt");fs.writeFileSync(probe,"1");assert.equal(fs.readFileSync(probe,"utf8"),"1")});it("can wipe the overlay when keepCliOverlay is false",()=>{root=fs.mkdtempSync(path.join(os.tmpdir(),"cocos-clean-cache-"));writeFile(path.join(root,"temp","cocos-cli","bin","cocos"),"ok");const removed=cleanCocosProjectCaches(root,{keepCliOverlay:false});assert.deepEqual(removed,["temp"]);assert.equal(fs.existsSync(path.join(root,"temp")),false)})});describe("shouldCleanCocosCache",()=>{it("defaults off, env and cocos.cleanCache win",()=>{assert.equal(shouldCleanCocosCache({},{}),false);assert.equal(shouldCleanCocosCache({cocos:{cleanCache:true}},{}),true);assert.equal(shouldCleanCocosCache({cocos:{cleanCache:true}},{PLAYABLE_KEEP_COCOS_CACHE:"1"}),false);assert.equal(shouldCleanCocosCache({cocos:{cleanCache:false}},{PLAYABLE_CLEAN_COCOS_CACHE:"1"}),true)})});