@fps-games/editor-deployment 0.2.3-beta.4 → 0.2.3-beta.5

package/bin/fps-editor-prepare.mjs

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-import{createHash as H,randomBytes as G}from"node:crypto";import{once as Q}from"node:events";import{chmod as X,copyFile as B,mkdir as g,mkdtemp as V,readFile as f,readdir as C,rename as I,rm as w,stat as j,writeFile as A}from"node:fs/promises";import{spawn as Y}from"node:child_process";import{fileURLToPath as Z}from"node:url";import e from"node:path";var tt=e.dirname(Z(import.meta.url)),F=e.resolve(tt,".."),n=e.resolve(process.cwd()),T=e.join(n,"node_modules/vite/bin/vite.js"),k=e.join(n,".fps-editor"),b=e.join(k,"deployments"),E=e.join(k,"adapters"),O=e.join(k,"state"),U=e.join(k,"current.json"),D=e.join(O,"runtime-bridge-token"),et=process.argv.includes("--reset-test-state"),rt=e.join(O,"playwright-working-document-journal.json"),P=JSON.parse(await f(e.join(n,"node_modules/@fps-games/editor/dist/build-info.json"),"utf8")),x=await ft();yt();et&&await w(rt,{force:!0});await g(b,{recursive:!0});await g(E,{recursive:!0});await g(O,{recursive:!0,mode:448});await lt();var l=await dt(),S=JSON.parse(await f(e.join(F,"manifest.json"),"utf8"));st(S,P);await at(F,S.files);var W=L(S.files);l&&l.editorDistHash===P.distHash&&l.projectSourceHash===x&&l.deployment?.packageHash===W&&await ct(l)&&(console.log("[fps-editor-server] existing deployment and Project Adapter are current."),process.exit(0));var s=await it(F,S,W),p=await nt(P,s),ot=["a","b"].map(t=>({release:t,artifactId:`${s.id}-${t}`,rootPath:e.relative(n,e.join(s.rootPath,"public")),build:{...s.manifest.build,buildId:`${s.manifest.build.buildId}.release-${t}`}})),K={schemaVersion:2,preparedAt:new Date().toISOString(),editorDistHash:P.distHash,projectSourceHash:x,deployment:{id:s.id,rootPath:e.relative(n,s.rootPath),packageHash:s.packageHash,manifest:s.manifest},adapter:{id:p.id,rootPath:e.relative(n,p.rootPath),browserRoot:e.relative(n,p.browserRoot),browserEntry:p.browserEntry,workerEntry:e.relative(n,p.workerEntry),manifest:p.manifest},workerEntry:e.relative(n,e.join(s.rootPath,s.manifest.entrypoints.worker)),serverEntry:e.relative(n,e.join(s.rootPath,s.manifest.entrypoints.server)),builds:ot,staged:l?.deployment?.id&&l.deployment.id!==s.id?{deploymentId:l.deployment.id,adapterId:l.adapter?.id??null}:null};await ut(U,K);await pt(K);console.log([`[fps-editor-server] prepared deployment ${s.id}`,`and Project Adapter ${p.id}`,`(browser ${M(p.manifest.sizes.browserBytes)},`,`worker ${M(p.manifest.sizes.workerBytes)}).`].join(" "));async function it(t,o,r){let i=await V(e.join(b,".install-"));try{for(let u of o.files){let v=e.join(i,u.path);await g(e.dirname(v),{recursive:!0}),await B(e.join(t,u.path),v)}await B(e.join(t,"manifest.json"),e.join(i,"manifest.json"));let a=`${o.version}-${r.slice(0,16)}`,c=e.join(b,a);return(await j(c).catch(()=>null))?.isDirectory()?await w(i,{recursive:!0,force:!0}):await I(i,c),{id:a,rootPath:c,manifest:o,packageHash:r}}finally{await w(i,{recursive:!0,force:!0}).catch(()=>{})}}async function nt(t,o){let r=await V(e.join(E,".build-")),i=e.join(r,"browser"),a=e.join(r,"worker");try{await z(process.execPath,[T,"build","--config",e.join(n,"vite.editor-project-adapter.config.ts")],{...process.env,FPS_EDITOR_PROJECT_ADAPTER_OUT_DIR:e.relative(n,i)}),await z(process.execPath,[T,"build","--config",e.join(n,"vite.editor-server-worker.config.ts")],{...process.env,FPS_EDITOR_SERVER_WORKER_OUT_DIR:e.relative(n,a)});let c=e.join(i,".vite/manifest.json"),h=JSON.parse(await f(c,"utf8")),u=Object.values(h).find(d=>d?.isEntry)?.file;if(typeof u!="string")throw new Error("Project browser Adapter entry is missing.");await w(e.dirname(c),{recursive:!0,force:!0});let v=e.join(a,"project-adapter.mjs");if(!(await j(v).catch(()=>null))?.isFile())throw new Error("Project worker Adapter entry is missing.");let m=await wt(r),R=`project-adapter-${L(m).slice(0,20)}`,_={schemaVersion:1,artifactKind:"fps-editor-project-adapter",artifactId:R,editorDistHash:t.distHash,deploymentPackageHash:o.packageHash,projectSourceHash:x,browserEntry:u,workerEntry:"worker/project-adapter.mjs",projectAssetsBundled:!1,files:m,sizes:{browserBytes:m.filter(d=>d.path.startsWith("browser/")).reduce((d,$)=>d+$.size,0),workerBytes:m.filter(d=>d.path.startsWith("worker/")).reduce((d,$)=>d+$.size,0)}};await A(e.join(r,"manifest.json"),`${JSON.stringify(_,null,2)}
-`),mt(m);let y=e.join(E,R);return(await j(y).catch(()=>null))?.isDirectory()?await w(r,{recursive:!0,force:!0}):await I(r,y),{id:R,rootPath:y,browserRoot:e.join(y,"browser"),browserEntry:u,workerEntry:e.join(y,"worker/project-adapter.mjs"),manifest:_}}finally{await w(r,{recursive:!0,force:!0}).catch(()=>{})}}function st(t,o){if(t?.schemaVersion!==2||t.artifactKind!=="fps-editor-deployment-package"||t.packageName!=="@fps-games/editor-deployment")throw new Error("Editor deployment manifest is invalid.");if(t.node?.range!==">=24 <27"||t.node?.bundled!==!1)throw new Error("Editor deployment Node.js contract is invalid.");if(t.build?.version!==o.version||t.build?.distHash!==o.distHash)throw new Error("Editor deployment does not match the installed @fps-games/editor package.");if(typeof o.gitSha!="string"||t.commitSha!==o.gitSha)throw new Error("Editor deployment commit does not match the installed @fps-games/editor package.");for(let r of["server","worker","browser"])if(typeof t.entrypoints?.[r]!="string")throw new Error(`Editor deployment ${r} entrypoint is missing.`);for(let r of["prepare","server"])if(typeof t.binaries?.[r]!="string")throw new Error(`Editor deployment ${r} binary is missing.`);if(t.projectContentBundled!==!1)throw new Error("Editor deployment must not contain project content.")}async function at(t,o){if(!Array.isArray(o)||o.length===0)throw new Error("Editor deployment file manifest is empty.");for(let r of o){if(!ht(r.path))throw new Error(`Unsafe deployment file path: ${String(r.path)}.`);let i=await f(e.join(t,r.path));if(i.byteLength!==r.size||q(i)!==r.sha256)throw new Error(`Editor deployment file integrity mismatch: ${r.path}.`)}}async function ct(t){try{let o=[t.serverEntry,t.workerEntry,e.join(t.adapter.browserRoot,t.adapter.browserEntry),t.adapter.workerEntry];return(await Promise.all(o.map(r=>j(e.join(n,r))))).every(r=>r.isFile())}catch{return!1}}async function dt(){try{let t=JSON.parse(await f(U,"utf8"));return t?.schemaVersion===2?t:null}catch{return null}}async function pt(t){let o=new Set([t.deployment.id,t.staged?.deploymentId].filter(Boolean)),r=new Set([t.adapter.id,t.staged?.adapterId].filter(Boolean));await J(b,o),await J(E,r)}async function J(t,o){for(let r of await C(t,{withFileTypes:!0}))!r.isDirectory()||r.name.startsWith(".")||o.has(r.name)||await w(e.join(t,r.name),{recursive:!0,force:!0})}async function lt(){(await f(D,"utf8").catch(()=>"")).trim()||(await A(D,`${G(32).toString("base64url")}
-`,{encoding:"utf8",mode:384}),await X(D,384))}async function ft(){let t=H("sha256"),o=["fps.config.ts","vite.editor-project-adapter.config.ts","vite.editor-server-worker.config.ts","src"];for(let r of o){let i=e.join(n,r),c=(await j(i)).isDirectory()?await N(i):[i];for(let h of c)t.update(e.relative(n,h).split(e.sep).join("/")).update("\0"),t.update(await f(h)).update("\0")}return t.digest("hex")}async function wt(t){let o=[];for(let r of await N(t)){let i=await f(r);o.push({path:e.relative(t,r).split(e.sep).join("/"),size:i.byteLength,sha256:q(i)})}return o}async function N(t){let o=[];for(let r of(await C(t,{withFileTypes:!0})).sort((i,a)=>i.name.localeCompare(a.name))){let i=e.join(t,r.name);r.isDirectory()?o.push(...await N(i)):r.isFile()&&o.push(i)}return o}async function ut(t,o){await g(e.dirname(t),{recursive:!0});let r=`${t}.${process.pid}.tmp`;await A(r,`${JSON.stringify(o,null,2)}
-`),await I(r,t)}async function z(t,o,r=process.env){let i=Y(t,o,{cwd:n,env:r,stdio:"inherit"}),[a,c]=await Q(i,"exit");if(a!==0)throw new Error(`Editor Server preparation failed (${c??a??"unknown"}).`)}function ht(t){return typeof t=="string"&&t.length>0&&!t.includes("\\")&&!e.isAbsolute(t)&&!t.split("/").includes("..")}function mt(t){let o=t.filter(r=>/\.(?:env|glb|gltf|ktx2?|basis|png|jpe?g|webp|wav|mp3|ogg)$/i.test(r.path));if(o.length>0)throw new Error(`Project Adapter bundled project assets: ${o.map(r=>r.path).join(", ")}.`)}function L(t){return H("sha256").update(JSON.stringify(t)).digest("hex")}function q(t){return H("sha256").update(t).digest("hex")}function yt(){let t=Number.parseInt(process.versions.node.split(".")[0]??"",10);if(!Number.isSafeInteger(t)||t<24||t>=27)throw new Error(`prepare:server requires Node.js >=24 <27; current version is ${process.versions.node}.`)}function M(t){return`${(t/1024/1024).toFixed(2)} MiB`}
+import{createHash as m,randomBytes as A}from"node:crypto";import{chmod as I,copyFile as P,mkdir as l,mkdtemp as N,readFile as f,readdir as R,rename as $,rm as d,stat as h,writeFile as D}from"node:fs/promises";import{fileURLToPath as J,pathToFileURL as O}from"node:url";import e from"node:path";var T=e.dirname(J(import.meta.url)),w=e.resolve(T,".."),a=e.resolve(process.cwd()),g=e.join(a,".fps-editor"),p=e.join(g,"deployments"),j=e.join(g,"state"),k=e.join(g,"current.json"),y=e.join(j,"runtime-bridge-token"),V=process.argv.includes("--reset-test-state"),C=e.join(j,"playwright-working-document-journal.json");et();V&&await d(C,{force:!0});await l(p,{recursive:!0});await l(j,{recursive:!0,mode:448});await G();var s=await z(),c=JSON.parse(await f(e.join(w,"manifest.json"),"utf8"));M(c);var v=await Q(),F=X(v);await U(w,c.files);var H=_(c.files);s&&s.editorDistHash===c.build.distHash&&s.projectSourceHash===F&&s.deployment?.packageHash===H&&await q(s)&&(console.log("[fps-editor-server] existing deployment and static Project definition are current."),process.exit(0));var n=await L(w,c,H),B=["a","b"].map(t=>({release:t,artifactId:`${n.id}-${t}`,rootPath:e.relative(a,e.join(n.rootPath,"public")),build:{...n.manifest.build,buildId:`${n.manifest.build.buildId}.release-${t}`}})),x={schemaVersion:3,preparedAt:new Date().toISOString(),editorDistHash:c.build.distHash,projectSourceHash:F,projectDefinition:v,deployment:{id:n.id,rootPath:e.relative(a,n.rootPath),packageHash:n.packageHash,manifest:n.manifest},workerEntry:e.relative(a,e.join(n.rootPath,n.manifest.entrypoints.worker)),serverEntry:e.relative(a,e.join(n.rootPath,n.manifest.entrypoints.server)),builds:B,staged:s?.deployment?.id&&s.deployment.id!==n.id?{deploymentId:s.deployment.id}:null};await Y(k,x);await K(x);console.log([`[fps-editor-server] prepared deployment ${n.id}`,`for static Project ${v.projectId}.`].join(" "));async function L(t,r,i){let o=await N(e.join(p,".install-"));try{for(let E of r.files){let S=e.join(o,E.path);await l(e.dirname(S),{recursive:!0}),await P(e.join(t,E.path),S)}await P(e.join(t,"manifest.json"),e.join(o,"manifest.json"));let b=`${r.version}-${i.slice(0,16)}`,u=e.join(p,b);return(await h(u).catch(()=>null))?.isDirectory()?await d(o,{recursive:!0,force:!0}):await $(o,u),{id:b,rootPath:u,manifest:r,packageHash:i}}finally{await d(o,{recursive:!0,force:!0}).catch(()=>{})}}function M(t){if(t?.schemaVersion!==2||t.artifactKind!=="fps-editor-deployment-package"||t.packageName!=="@fps-games/editor-deployment")throw new Error("Editor deployment manifest is invalid.");if(t.node?.range!==">=24 <27"||t.node?.bundled!==!1)throw new Error("Editor deployment Node.js contract is invalid.");if(typeof t.build?.version!="string"||typeof t.build?.distHash!="string"||typeof t.commitSha!="string")throw new Error("Editor deployment build identity is incomplete.");for(let r of["server","worker","browser"])if(typeof t.entrypoints?.[r]!="string")throw new Error(`Editor deployment ${r} entrypoint is missing.`);for(let r of["prepare","server","project"])if(typeof t.binaries?.[r]!="string")throw new Error(`Editor deployment ${r} binary is missing.`);if(t.projectContentBundled!==!1)throw new Error("Editor deployment must not contain project content.")}async function U(t,r){if(!Array.isArray(r)||r.length===0)throw new Error("Editor deployment file manifest is empty.");for(let i of r){if(!Z(i.path))throw new Error(`Unsafe deployment file path: ${String(i.path)}.`);let o=await f(e.join(t,i.path));if(o.byteLength!==i.size||tt(o)!==i.sha256)throw new Error(`Editor deployment file integrity mismatch: ${i.path}.`)}}async function q(t){try{let r=[t.serverEntry,t.workerEntry,e.join(t.deployment.rootPath,t.deployment.manifest.entrypoints.browser)];return(await Promise.all(r.map(i=>h(e.join(a,i))))).every(i=>i.isFile())}catch{return!1}}async function z(){try{let t=JSON.parse(await f(k,"utf8"));return t?.schemaVersion===3?t:null}catch{return null}}async function K(t){let r=new Set([t.deployment.id,t.staged?.deploymentId].filter(Boolean));await W(p,r)}async function W(t,r){for(let i of await R(t,{withFileTypes:!0}))!i.isDirectory()||i.name.startsWith(".")||r.has(i.name)||await d(e.join(t,i.name),{recursive:!0,force:!0})}async function G(){(await f(y,"utf8").catch(()=>"")).trim()||(await D(y,`${A(32).toString("base64url")}
+`,{encoding:"utf8",mode:384}),await I(y,384))}async function Q(){let t=e.join(a,"fps.config.ts");if(!(await h(t).catch(()=>null))?.isFile())throw new Error("fps.config.ts is required.");let i=await import(`${O(t).href}?fps-editor-prepare=${Date.now()}`),o=i.default??i.fpsConfig;if(!o||typeof o!="object"||Array.isArray(o)||o.schemaVersion!==1||typeof o.projectId!="string"||!o.authoring||!Array.isArray(o.plugins))throw new Error("fps.config.ts must default-export a valid defineFpsProject() definition.");return o}function X(t){return m("sha256").update(JSON.stringify(t)).digest("hex")}async function Y(t,r){await l(e.dirname(t),{recursive:!0});let i=`${t}.${process.pid}.tmp`;await D(i,`${JSON.stringify(r,null,2)}
+`),await $(i,t)}function Z(t){return typeof t=="string"&&t.length>0&&!t.includes("\\")&&!e.isAbsolute(t)&&!t.split("/").includes("..")}function _(t){return m("sha256").update(JSON.stringify(t)).digest("hex")}function tt(t){return m("sha256").update(t).digest("hex")}function et(){let t=Number.parseInt(process.versions.node.split(".")[0]??"",10);if(!Number.isSafeInteger(t)||t<24||t>=27)throw new Error(`prepare:server requires Node.js >=24 <27; current version is ${process.versions.node}.`)}