@fps-games/editor-deployment 0.2.3-beta.6 → 0.2.3-beta.7

package/bin/fps-editor-prepare.mjs

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import{createHash as y,randomBytes as O}from"node:crypto";import{chmod as J,copyFile as k,mkdir as u,mkdtemp as V,readFile as m,readdir as T,rename as x,rm as l,stat as w,writeFile as F}from"node:fs/promises";import{fileURLToPath as C,pathToFileURL as B}from"node:url";import e from"node:path";import N from"node:path";function $(t){let r=[],o;for(let i=0;i<t.length;i+=1){let s=t[i];if(s!=="--project-root"&&!s.startsWith("--project-root=")){r.push(s);continue}if(o!==void 0)throw new Error("--project-root may only be provided once.");let a=s==="--project-root"?t[++i]:s.slice(15);if(a===void 0||!a.trim()||a.startsWith("--"))throw new Error("--project-root requires a non-empty path.");o=a}return{argv:r,projectRoot:N.resolve(process.cwd(),o??"."),explicit:o!==void 0}}var L=e.dirname(C(import.meta.url)),g=e.resolve(L,".."),j=$(process.argv.slice(2)),U=j.argv.includes("--reset-test-state"),D=j.argv.filter(t=>t!=="--reset-test-state");if(D.length>0)throw new Error(`Unexpected argument: ${D[0]}`);var p=j.projectRoot,v=e.join(p,".fps-editor"),f=e.join(v,"deployments"),b=e.join(v,"state"),R=e.join(v,"current.json"),h=e.join(b,"runtime-bridge-token"),q=e.join(b,"playwright-working-document-journal.json");nt();U&&await l(q,{force:!0});await u(f,{recursive:!0});await u(b,{recursive:!0,mode:448});await Z();var c=await Q(),d=JSON.parse(await m(e.join(g,"manifest.json"),"utf8"));z(d);var E=await _(),A=tt(E);await K(g,d.files);var H=rt(d.files);c&&c.editorDistHash===d.build.distHash&&c.projectSourceHash===A&&c.deployment?.packageHash===H&&await G(c)&&(console.log("[fps-editor-server] existing deployment and static Project definition are current."),process.exit(0));var n=await W(g,d,H),M=["a","b"].map(t=>({release:t,artifactId:`${n.id}-${t}`,rootPath:e.relative(p,e.join(n.rootPath,"public")),build:{...n.manifest.build,buildId:`${n.manifest.build.buildId}.release-${t}`}})),I={schemaVersion:3,preparedAt:new Date().toISOString(),editorDistHash:d.build.distHash,projectSourceHash:A,projectDefinition:E,deployment:{id:n.id,rootPath:e.relative(p,n.rootPath),packageHash:n.packageHash,manifest:n.manifest},workerEntry:e.relative(p,e.join(n.rootPath,n.manifest.entrypoints.worker)),serverEntry:e.relative(p,e.join(n.rootPath,n.manifest.entrypoints.server)),builds:M,staged:c?.deployment?.id&&c.deployment.id!==n.id?{deploymentId:c.deployment.id}:null};await et(R,I);await X(I);console.log([`[fps-editor-server] prepared deployment ${n.id}`,`for static Project ${E.projectId}.`].join(" "));async function W(t,r,o){let i=await V(e.join(f,".install-"));try{for(let P of r.files){let S=e.join(i,P.path);await u(e.dirname(S),{recursive:!0}),await k(e.join(t,P.path),S)}await k(e.join(t,"manifest.json"),e.join(i,"manifest.json"));let s=`${r.version}-${o.slice(0,16)}`,a=e.join(f,s);return(await w(a).catch(()=>null))?.isDirectory()?await l(i,{recursive:!0,force:!0}):await x(i,a),{id:s,rootPath:a,manifest:r,packageHash:o}}finally{await l(i,{recursive:!0,force:!0}).catch(()=>{})}}function z(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","agent"])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 K(t,r){if(!Array.isArray(r)||r.length===0)throw new Error("Editor deployment file manifest is empty.");for(let o of r){if(!ot(o.path))throw new Error(`Unsafe deployment file path: ${String(o.path)}.`);let i=await m(e.join(t,o.path));if(i.byteLength!==o.size||it(i)!==o.sha256)throw new Error(`Editor deployment file integrity mismatch: ${o.path}.`)}}async function G(t){try{let r=[t.serverEntry,t.workerEntry,e.join(t.deployment.rootPath,t.deployment.manifest.entrypoints.browser)];return(await Promise.all(r.map(o=>w(e.join(p,o))))).every(o=>o.isFile())}catch{return!1}}async function Q(){try{let t=JSON.parse(await m(R,"utf8"));return t?.schemaVersion===3?t:null}catch{return null}}async function X(t){let r=new Set([t.deployment.id,t.staged?.deploymentId].filter(Boolean));await Y(f,r)}async function Y(t,r){for(let o of await T(t,{withFileTypes:!0}))!o.isDirectory()||o.name.startsWith(".")||r.has(o.name)||await l(e.join(t,o.name),{recursive:!0,force:!0})}async function Z(){(await m(h,"utf8").catch(()=>"")).trim()||(await F(h,`${O(32).toString("base64url")}
-`,{encoding:"utf8",mode:384}),await J(h,384))}async function _(){let t=e.join(p,"fps.config.ts");if(!(await w(t).catch(()=>null))?.isFile())throw new Error("fps.config.ts is required.");let o=await import(`${B(t).href}?fps-editor-prepare=${Date.now()}`),i=o.default??o.fpsConfig;if(!i||typeof i!="object"||Array.isArray(i)||i.schemaVersion!==1||typeof i.projectId!="string"||!i.authoring||!Array.isArray(i.plugins))throw new Error("fps.config.ts must default-export a valid defineFpsProject() definition.");return i}function tt(t){return y("sha256").update(JSON.stringify(t)).digest("hex")}async function et(t,r){await u(e.dirname(t),{recursive:!0});let o=`${t}.${process.pid}.tmp`;await F(o,`${JSON.stringify(r,null,2)}
-`),await x(o,t)}function ot(t){return typeof t=="string"&&t.length>0&&!t.includes("\\")&&!e.isAbsolute(t)&&!t.split("/").includes("..")}function rt(t){return y("sha256").update(JSON.stringify(t)).digest("hex")}function it(t){return y("sha256").update(t).digest("hex")}function nt(){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}.`)}
+import{createHash as w,randomBytes as z}from"node:crypto";import{chmod as K,copyFile as x,mkdir as u,mkdtemp as G,readFile as m,readdir as Q,rename as N,rm as l,stat as g,writeFile as A}from"node:fs/promises";import{fileURLToPath as X,pathToFileURL as Y}from"node:url";import r from"node:path";import T from"node:path";function R(t){let e=[],o;for(let i=0;i<t.length;i+=1){let s=t[i];if(s!=="--project-root"&&!s.startsWith("--project-root=")){e.push(s);continue}if(o!==void 0)throw new Error("--project-root may only be provided once.");let a=s==="--project-root"?t[++i]:s.slice(15);if(a===void 0||!a.trim()||a.startsWith("--"))throw new Error("--project-root requires a non-empty path.");o=a}return{argv:e,projectRoot:T.resolve(process.cwd(),o??"."),explicit:o!==void 0}}import{existsSync as J,statSync as M}from"node:fs";import{registerHooks as V}from"node:module";import D from"node:path";import{fileURLToPath as W,pathToFileURL as C}from"node:url";var k=[".ts",".mts",".js",".mjs",".cjs"];async function F(t){let e=V({resolve:B});try{return await import(t)}finally{e.deregister()}}function B(t,e,o){try{return o(t,e)}catch(i){if(i?.code!=="ERR_MODULE_NOT_FOUND"||!e.parentURL?.startsWith("file:")||!t.startsWith("./")&&!t.startsWith("../"))throw i;let s=new URL(t,e.parentURL);if(s.protocol!=="file:"||D.extname(s.pathname))throw i;let a=W(s);for(let h of q(a))if(_(h))return o(C(h).href,e);throw i}}function q(t){return[...k.map(e=>`${t}${e}`),...k.map(e=>D.join(t,`index${e}`))]}function _(t){try{return J(t)&&M(t).isFile()}catch{return!1}}var Z=r.dirname(X(import.meta.url)),j=r.resolve(Z,".."),v=R(process.argv.slice(2)),tt=v.argv.includes("--reset-test-state"),H=v.argv.filter(t=>t!=="--reset-test-state");if(H.length>0)throw new Error(`Unexpected argument: ${H[0]}`);var p=v.projectRoot,b=r.join(p,".fps-editor"),f=r.join(b,"deployments"),E=r.join(b,"state"),U=r.join(b,"current.json"),y=r.join(E,"runtime-bridge-token"),et=r.join(E,"playwright-working-document-journal.json");wt();tt&&await l(et,{force:!0});await u(f,{recursive:!0});await u(E,{recursive:!0,mode:448});await dt();var c=await at(),d=JSON.parse(await m(r.join(j,"manifest.json"),"utf8"));it(d);var P=await lt(),I=ft(P);await nt(j,d.files);var O=ht(d.files);c&&c.editorDistHash===d.build.distHash&&c.projectSourceHash===I&&c.deployment?.packageHash===O&&await st(c)&&(console.log("[fps-editor-server] existing deployment and static Project definition are current."),process.exit(0));var n=await rt(j,d,O),ot=["a","b"].map(t=>({release:t,artifactId:`${n.id}-${t}`,rootPath:r.relative(p,r.join(n.rootPath,"public")),build:{...n.manifest.build,buildId:`${n.manifest.build.buildId}.release-${t}`}})),L={schemaVersion:3,preparedAt:new Date().toISOString(),editorDistHash:d.build.distHash,projectSourceHash:I,projectDefinition:P,deployment:{id:n.id,rootPath:r.relative(p,n.rootPath),packageHash:n.packageHash,manifest:n.manifest},workerEntry:r.relative(p,r.join(n.rootPath,n.manifest.entrypoints.worker)),serverEntry:r.relative(p,r.join(n.rootPath,n.manifest.entrypoints.server)),builds:ot,staged:c?.deployment?.id&&c.deployment.id!==n.id?{deploymentId:c.deployment.id}:null};await ut(U,L);await ct(L);console.log([`[fps-editor-server] prepared deployment ${n.id}`,`for static Project ${P.projectId}.`].join(" "));async function rt(t,e,o){let i=await G(r.join(f,".install-"));try{for(let S of e.files){let $=r.join(i,S.path);await u(r.dirname($),{recursive:!0}),await x(r.join(t,S.path),$)}await x(r.join(t,"manifest.json"),r.join(i,"manifest.json"));let s=`${e.version}-${o.slice(0,16)}`,a=r.join(f,s);return(await g(a).catch(()=>null))?.isDirectory()?await l(i,{recursive:!0,force:!0}):await N(i,a),{id:s,rootPath:a,manifest:e,packageHash:o}}finally{await l(i,{recursive:!0,force:!0}).catch(()=>{})}}function it(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 e of["server","worker","browser"])if(typeof t.entrypoints?.[e]!="string")throw new Error(`Editor deployment ${e} entrypoint is missing.`);for(let e of["prepare","server","project","agent"])if(typeof t.binaries?.[e]!="string")throw new Error(`Editor deployment ${e} binary is missing.`);if(t.projectContentBundled!==!1)throw new Error("Editor deployment must not contain project content.")}async function nt(t,e){if(!Array.isArray(e)||e.length===0)throw new Error("Editor deployment file manifest is empty.");for(let o of e){if(!mt(o.path))throw new Error(`Unsafe deployment file path: ${String(o.path)}.`);let i=await m(r.join(t,o.path));if(i.byteLength!==o.size||yt(i)!==o.sha256)throw new Error(`Editor deployment file integrity mismatch: ${o.path}.`)}}async function st(t){try{let e=[t.serverEntry,t.workerEntry,r.join(t.deployment.rootPath,t.deployment.manifest.entrypoints.browser)];return(await Promise.all(e.map(o=>g(r.join(p,o))))).every(o=>o.isFile())}catch{return!1}}async function at(){try{let t=JSON.parse(await m(U,"utf8"));return t?.schemaVersion===3?t:null}catch{return null}}async function ct(t){let e=new Set([t.deployment.id,t.staged?.deploymentId].filter(Boolean));await pt(f,e)}async function pt(t,e){for(let o of await Q(t,{withFileTypes:!0}))!o.isDirectory()||o.name.startsWith(".")||e.has(o.name)||await l(r.join(t,o.name),{recursive:!0,force:!0})}async function dt(){(await m(y,"utf8").catch(()=>"")).trim()||(await A(y,`${z(32).toString("base64url")}
+`,{encoding:"utf8",mode:384}),await K(y,384))}async function lt(){let t=r.join(p,"fps.config.ts");if(!(await g(t).catch(()=>null))?.isFile())throw new Error("fps.config.ts is required.");let o=await F(`${Y(t).href}?fps-editor-prepare=${Date.now()}`),i=o.default??o.fpsConfig;if(!i||typeof i!="object"||Array.isArray(i)||i.schemaVersion!==1||typeof i.projectId!="string"||!i.authoring||!Array.isArray(i.plugins))throw new Error("fps.config.ts must default-export a valid defineFpsProject() definition.");return i}function ft(t){return w("sha256").update(JSON.stringify(t)).digest("hex")}async function ut(t,e){await u(r.dirname(t),{recursive:!0});let o=`${t}.${process.pid}.tmp`;await A(o,`${JSON.stringify(e,null,2)}
+`),await N(o,t)}function mt(t){return typeof t=="string"&&t.length>0&&!t.includes("\\")&&!r.isAbsolute(t)&&!t.split("/").includes("..")}function ht(t){return w("sha256").update(JSON.stringify(t)).digest("hex")}function yt(t){return w("sha256").update(t).digest("hex")}function wt(){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}.`)}