@salsita-ai/sdk 0.50.0-develop.dfac20c66b → 0.50.0-develop.e33c8d8711

package/dist/phoenix/commands/dev.js

@@ -1,5 +1,5 @@
-import{format as e}from"node:util";import{createServer as t}from"vite";import{startEditorServer as r}from"../editor-server/index.js";import{getDevelopmentCredentialHint as o}from"../services/development-credential.js";import{ApplicationSpecProjectWatcher as n,LinguiWatcher as s,LogBus as i,MockTemplateWatcher as a,PhoenixPubSub as l,WebhookTunnelMonitor as c,createBusLogger as p,getViteDevConfig as d,patchConsole as u,setViteLogSink as m}from"../services/index.js";import{prepareDevelopmentEnvironment as g}from"../services/prepare-development-environment.js";import{createWebhookTunnelTransport as w,readOrCreateTunnelSessionId as v,startWebhookService as h}from"../services/webhook-service/index.js";import{startTui as f}from"../tui/index.js";import{FileLogger as E,createLogger as b,exists as S}from"../utils/index.js";import{buildWebhooks as I,setLogger as k,webhookLogContext as $}from"../webhooks/index.js";import{generateProjectFilesAndInstallDependencies as x}from"./generate-project-files.js";import{readGeneratedEnvMarkers as j}from"./generated-env-markers.js";export const runDevCommand=async(T,P)=>{let{logger:R}=P,{sdkVersion:N,projectSlug:D,environmentSlug:y,cliUseWorkspace:_,enableEditor:O,editorWsPort:L,debug:U=!1,withLingui:V=!1,persistenceMode:M,force:W=!1,tui:G=!1,serverUrl:Y,credential:C,skipUpload:H}=T,B=null,X=null,q=null,F=null,J=null,Q=null,z=new E,A=new l,K=new i,Z=G&&!!process.stdout.isTTY&&!!process.stdin.isTTY,ee=!Z,et=null;G&&!Z&&R.warn("TUI requested but stdin/stdout is not an interactive terminal — falling back to plain log output. Run phoenix dev --tui directly in a terminal to use the TUI.");let er=null,eo=R,en=null,es=()=>{et&&(et(),et=null),er&&(er.unmount(),er=null,eo=b({debug:U,fileLogger:z}))},ei=(e=0)=>en||(en=(async()=>{process.off("SIGINT",ea),process.off("SIGTERM",ea),process.off("uncaughtException",el),es(),eo.debug("Shutting down...");let t=[];for(let e of[{name:"lingui watcher",close:()=>F?.close()},{name:"project watcher",close:()=>Q?.close()},{name:"mock template watcher",close:()=>J?.close()},{name:"editor server",close:()=>q?.close()},{name:"vite server",close:()=>B?.close()},{name:"webhook tunnel",close:()=>X?.stop()}])try{eo.debug(`Shutting down ${e.name}`),await e.close()}catch(r){t.push(`${e.name}: ${r instanceof Error?r.message:String(r)}`)}t.length>0&&eo.warn(`Cleanup warnings:
-  ${t.join("\n  ")}`),eo.debug("Shutdown complete"),await z.close(),process.exit(e)})()),ea=()=>{ei(0)},el=e=>{es(),eo.error(`Uncaught exception: ${e.message}`),ei(1)};process.once("SIGINT",ea),process.once("SIGTERM",ea),process.once("uncaughtException",el);try{await z.init(".phoenix"),eo=p({bus:K,stream:"spec",debug:U,fileLogger:z,echo:!0}),m((e,t)=>K.push("vite",e,t),{echo:ee}),k({transports:[],log:(t,...r)=>{K.push("webhook","warn"===t||"error"===t?t:"info",e(...r)),ee&&process.stdout.write(`${e(t,...r)}
-`)}}),A.browserConsole$.subscribe(e=>{K.push("browser",e.level,e.source?`[${e.source}] ${e.message}`:e.message);let t=`[${e.source?`browser:${e.source}`:"browser"}] ${e.message}`;z.write("warn",t),ee&&process.stderr.write(`⚠️  ${t}
-`)}),ee&&(et=u(K,{echo:!0})),process.env.NODE_ENV="development",M&&(process.env.PERSISTENCE_MODE=M);let i=!M||"server"===M;i&&Y&&(process.env.SERVER_URL=Y);let l=i&&Y?new c(Y):void 0;if(eo.step("Starting development mode"),!await S("spec")){eo.error('Spec folder not found. Run "phoenix init" first.'),await ei(1);return}if(i){if(!Y||!C)throw Error("Server persistence needs a server and a credential. Run `phoenix login <workspace>`, or create a development environment in Studio and paste its .env block into .env.");let e=await j(".env.generated");e?.PHOENIX_PROJECT_SLUG!==D||e.PHOENIX_ENVIRONMENT_SLUG!==y||e.PHOENIX_SERVER_URL!==Y?(eo.step("Preparing development deployment"),await g({serverUrl:Y,projectSlug:D,environmentSlug:y,credential:C,outFile:".env.generated",skipUpload:H,overrideSchema:!0,debug:U,projectVersion:N},{logger:eo})):eo.debug(".env.generated matches the current development environment, skipping prepare")}eo.step("Building project files");let{templateFiles:E}=await x({sdkVersion:N,projectSlug:D,environmentSlug:y,cliUseWorkspace:_,enableEditor:O,withLingui:V,force:W},{logger:eo});if(eo.success("Project files built successfully"),Z&&(eo=p({bus:K,stream:"spec",debug:U,fileLogger:z}),et=u(K),er=f(K,{onQuit:()=>void ei(0)})),V?(F=new s({logger:eo})).start():eo.warn("Lingui is disabled: i18n messages are not extracted or compiled during dev. Pass --withLingui or set WITH_LINGUI=true to enable."),i&&(eo.step("Building webhooks"),await $.run("webhook",async()=>{await I({experimental:!0,skipNodeEnvOverride:!0,webhookEntryPoint:"./.phoenix/.swc/.phoenix/webhook.js"})})),i&&Y&&C){let e=await j(".env.generated");if(!e?.DEPLOYMENT_ID)throw Error("Webhook tunnel cannot start because .env.generated has no DEPLOYMENT_ID. Rerun phoenix dev to prepare the development deployment.");let t=await v();X=await h({experimental:!0,transport:w({serverUrl:Y,credential:C,projectSlug:D,environmentSlug:y}),rejectionHint:o(C,D),environmentSlug:y,deploymentId:e.DEPLOYMENT_ID,sessionId:t,onStatus:(r,o)=>{l?.setStatus(r,{deploymentId:e.DEPLOYMENT_ID,sessionId:t,message:o??null})},onRequest:e=>l?.record(e)}),l?.setStatus("waiting",{deploymentId:e.DEPLOYMENT_ID,sessionId:t}),X.stopped.catch(e=>{es(),eo.error(`Webhook tunnel failed: ${e instanceof Error?e.message:String(e)}`),ei(1)}),eo.success("Webhook tunnel started")}if(O&&L){eo.step("Starting editor WebSocket server");let e=parseInt(L,10);q=r({port:e,projectRoot:process.cwd(),pubsub:A,logger:eo,logBus:K,tunnelMonitor:l,debug:U,prepareDeployment:i&&Y&&C?()=>g({serverUrl:Y,projectSlug:D,environmentSlug:y,credential:C,outFile:".env.generated",skipUpload:!0,overrideSchema:!0,debug:!1,projectVersion:N},{logger:eo}):void 0}),await q.ready,eo.debug(`Editor WebSocket server started on port ${e}`),(J=new a({projectRoot:process.cwd(),pubsub:A,logger:eo})).start()}let b=await d({templateFiles:E});B=await t(b),await B.listen(),eo.step("Starting Vite dev server"),(Q=new n({viteServer:B,pubsub:A,logger:eo,onRebuilt:()=>F?.trigger(),onViteServerChange:e=>{B=e},sdkVersion:N,projectSlug:D,environmentSlug:y,cliUseWorkspace:_,enableEditor:O??!0,inlineTemplates:!1,useServer:i})).start();let T=B.resolvedUrls?.local[0];if(Z)eo.success("Vite dev server started — watching for changes"),T&&eo.info(`Preview: ${T}`),O&&L&&eo.info(`Editor WebSocket: ws://localhost:${L}`);else if(U)eo.success("Vite dev server started"),T&&eo.info(`Preview: ${T}`);else{let e=e=>{K.push("spec","info",e),process.stdout.write(`${e}
-`)};e("\n\uD83D\uDE80 Phoenix Dev Server\n"),T&&(e(`Preview: ${T}`),z.write("info",`Preview: ${T}`)),O&&L&&e(`Editor WebSocket: ws://localhost:${L}`),e("\n\uD83D\uDC40 Watching for changes...\n")}}catch(e){es(),eo.error(`Dev mode failed: ${e instanceof Error?e.message:String(e)}`,e),await ei(1)}};
+import{mkdir as e}from"node:fs/promises";import{dirname as r}from"node:path";import{format as t}from"node:util";import{createServer as o}from"vite";import{resolveGeneratedEnvFile as s}from"@salsita-ai/common/env";import{startEditorServer as n}from"../editor-server/index.js";import{getDevelopmentCredentialHint as i}from"../services/development-credential.js";import{ApplicationSpecProjectWatcher as a,LinguiWatcher as l,LogBus as c,MockTemplateWatcher as p,PhoenixApplication as d,PhoenixPubSub as u,PhoenixStore as m,VariantPreviewService as w,WebhookTunnelMonitor as v,createBusLogger as g,getViteDevConfig as h,patchConsole as f,setViteLogSink as E}from"../services/index.js";import{prepareDevelopmentEnvironment as b}from"../services/prepare-development-environment.js";import{createWebhookTunnelTransport as S,readOrCreateTunnelSessionId as k,startWebhookService as I}from"../services/webhook-service/index.js";import{startTui as $}from"../tui/index.js";import{FileLogger as x,createLogger as j,exists as P}from"../utils/index.js";import{buildWebhooks as R,setLogger as T,webhookLogContext as N}from"../webhooks/index.js";import{generateProjectFilesAndInstallDependencies as y}from"./generate-project-files.js";import{readGeneratedEnvMarkers as D}from"./generated-env-markers.js";export const runDevCommand=async(_,U)=>{let{logger:O}=U,{sdkVersion:L,projectSlug:M,environmentSlug:V,cliUseWorkspace:W,enableEditor:G,editorWsPort:Y,debug:C=!1,withLingui:H=!1,persistenceMode:B,force:X=!1,tui:q=!1,serverUrl:J,credential:Q,skipUpload:z}=_,A=null,F=null,K=null,Z=null,ee=null,er=null,et=null,eo=new x,es=new u,en=new c,ei=q&&!!process.stdout.isTTY&&!!process.stdin.isTTY,ea=!ei,el=null;q&&!ei&&O.warn("TUI requested but stdin/stdout is not an interactive terminal — falling back to plain log output. Run phoenix dev --tui directly in a terminal to use the TUI.");let ec=null,ep=O,ed=null,eu=async(t,o)=>{let n=s(".");await e(r(n),{recursive:!0}),await b({serverUrl:t.serverUrl,projectSlug:M,environmentSlug:V,credential:t.credential,outFile:n,skipUpload:o.skipUpload,overrideSchema:!0,debug:o.debug,projectVersion:L},{logger:ep})},em=()=>{el&&(el(),el=null),ec&&(ec.unmount(),ec=null,ep=j({debug:C,fileLogger:eo}))},ew=(e=0)=>ed||(ed=(async()=>{process.off("SIGINT",ev),process.off("SIGTERM",ev),process.off("uncaughtException",eg),em(),ep.debug("Shutting down...");let r=[];for(let e of[{name:"lingui watcher",close:()=>Z?.close()},{name:"project watcher",close:()=>er?.close()},{name:"mock template watcher",close:()=>ee?.close()},{name:"editor server",close:()=>K?.close()},{name:"variant previews",close:()=>et?.close()},{name:"vite server",close:()=>A?.close()},{name:"webhook tunnel",close:()=>F?.stop()}])try{ep.debug(`Shutting down ${e.name}`),await e.close()}catch(t){r.push(`${e.name}: ${t instanceof Error?t.message:String(t)}`)}r.length>0&&ep.warn(`Cleanup warnings:
+  ${r.join("\n  ")}`),ep.debug("Shutdown complete"),await eo.close(),process.exit(e)})()),ev=()=>{ew(0)},eg=e=>{em(),ep.error(`Uncaught exception: ${e.message}`),ew(1)};process.once("SIGINT",ev),process.once("SIGTERM",ev),process.once("uncaughtException",eg);try{await eo.init(".phoenix"),ep=g({bus:en,stream:"spec",debug:C,fileLogger:eo,echo:!0}),E((e,r)=>en.push("vite",e,r),{echo:ea}),T({transports:[],log:(e,...r)=>{en.push("webhook","warn"===e||"error"===e?e:"info",t(...r)),ea&&process.stdout.write(`${t(e,...r)}
+`)}}),es.browserConsole$.subscribe(e=>{en.push("browser",e.level,e.source?`[${e.source}] ${e.message}`:e.message);let r=`[${e.source?`browser:${e.source}`:"browser"}] ${e.message}`;eo.write("warn",r),ea&&process.stderr.write(`⚠️  ${r}
+`)}),ea&&(el=f(en,{echo:!0})),process.env.NODE_ENV="development",B&&(process.env.PERSISTENCE_MODE=B);let e=!B||"server"===B;e&&J&&(process.env.SERVER_URL=J);let r=e&&J?new v(J):void 0;if(ep.step("Starting development mode"),!await P("spec")){ep.error('Spec folder not found. Run "phoenix init" first.'),await ew(1);return}if(e){if(!J||!Q)throw Error("Server persistence needs a server and a credential. Run `phoenix login <workspace>`, or create a development environment in Studio and paste its .env block into .env.");let e=s("."),r=await D(e);r?.PHOENIX_PROJECT_SLUG!==M||r.PHOENIX_ENVIRONMENT_SLUG!==V||r.PHOENIX_SERVER_URL!==J?(ep.step("Preparing development deployment"),await eu({serverUrl:J,credential:Q},{skipUpload:z,debug:C})):ep.debug(`${e} matches the current development environment, skipping prepare`)}ep.step("Building project files");let{templateFiles:c}=await y({sdkVersion:L,projectSlug:M,environmentSlug:V,cliUseWorkspace:W,enableEditor:G,withLingui:H,force:X},{logger:ep});if(ep.success("Project files built successfully"),ei&&(ep=g({bus:en,stream:"spec",debug:C,fileLogger:eo}),el=f(en),ec=$(en,{onQuit:()=>void ew(0)})),H?(Z=new l({logger:ep})).start():ep.warn("Lingui is disabled: i18n messages are not extracted or compiled during dev. Pass --withLingui or set WITH_LINGUI=true to enable."),e&&(ep.step("Building webhooks"),await N.run("webhook",async()=>{await R({experimental:!0,skipNodeEnvOverride:!0,webhookEntryPoint:"./.phoenix/.swc/.phoenix/webhook.js"})})),e&&J&&Q){let e=s("."),t=await D(e);if(!t?.DEPLOYMENT_ID)throw Error(`Webhook tunnel cannot start because ${e} has no DEPLOYMENT_ID. Rerun phoenix dev to prepare the development deployment.`);let o=await k();F=await I({experimental:!0,transport:S({serverUrl:J,credential:Q,projectSlug:M,environmentSlug:V}),rejectionHint:i(Q,M),environmentSlug:V,deploymentId:t.DEPLOYMENT_ID,sessionId:o,onStatus:(e,s)=>{r?.setStatus(e,{deploymentId:t.DEPLOYMENT_ID,sessionId:o,message:s??null})},onRequest:e=>r?.record(e)}),r?.setStatus("waiting",{deploymentId:t.DEPLOYMENT_ID,sessionId:o}),F.stopped.catch(e=>{em(),ep.error(`Webhook tunnel failed: ${e instanceof Error?e.message:String(e)}`),ew(1)}),ep.success("Webhook tunnel started")}er=new a({pubsub:es,logger:ep,onRebuilt:()=>Z?.trigger(),onViteServerChange:e=>{A=e},sdkVersion:L,projectSlug:M,environmentSlug:V,cliUseWorkspace:W,enableEditor:G??!0,inlineTemplates:!1,useServer:e});let u=new m;if(et=new d({store:u,pubsub:es,variantPreviews:new w({projectRoot:process.cwd()},{store:u,logger:ep,projectWatcher:er})}),G&&Y){ep.step("Starting editor WebSocket server");let t=parseInt(Y,10);K=n({port:t,projectRoot:process.cwd(),application:et,logger:ep,logBus:en,tunnelMonitor:r,debug:C,prepareDeployment:e&&J&&Q?()=>eu({serverUrl:J,credential:Q},{skipUpload:!0,debug:!1}):void 0}),await K.ready,ep.debug(`Editor WebSocket server started on port ${t}`),(ee=new p({projectRoot:process.cwd(),pubsub:es,logger:ep})).start()}let b=await h({templateFiles:c});A=await o(b),await A.listen(),ep.step("Starting Vite dev server"),er.start(A);let x=A.resolvedUrls?.local[0];if(ei)ep.success("Vite dev server started — watching for changes"),x&&ep.info(`Preview: ${x}`),G&&Y&&ep.info(`Editor WebSocket: ws://localhost:${Y}`);else if(C)ep.success("Vite dev server started"),x&&ep.info(`Preview: ${x}`);else{let e=e=>{en.push("spec","info",e),process.stdout.write(`${e}
+`)};e("\n\uD83D\uDE80 Phoenix Dev Server\n"),x&&(e(`Preview: ${x}`),eo.write("info",`Preview: ${x}`)),G&&Y&&e(`Editor WebSocket: ws://localhost:${Y}`),e("\n\uD83D\uDC40 Watching for changes...\n")}}catch(e){em(),ep.error(`Dev mode failed: ${e instanceof Error?e.message:String(e)}`,e),await ew(1)}};

package/dist/phoenix/commands/fix.js

@@ -1 +1 @@
-import{runCommand as t}from"../utils/index.js";import{formatFiles as e}from"./prettier.js";export const runFixCommand=async(i,r)=>{let{logger:s}=r,o=!0===i.lint||!0===i.format,n=!o||!0===i.lint,c=!o||!0===i.format;try{s.step("Running fixes"),n&&await t({command:"eslint",args:["src","--fix"],description:"ESLint fix",quiet:!0},{logger:s}),c&&(s.step("Prettier fix"),await e(".",{logger:s}),s.success("Prettier fix completed")),s.success("Fixes completed!")}catch(t){s.error(`Fix failed: ${t instanceof Error?t.message:String(t)}`,t),process.exit(1)}};
+import{runCommand as t}from"../utils/index.js";import{formatFiles as e}from"./prettier.js";export const runFixCommand=async(r,i)=>{let{logger:s}=i,n=!0===r.lint||!0===r.format,o=!n||!0===r.lint,a=!n||!0===r.format;try{s.step("Running fixes"),o&&await t({command:"eslint",args:["src","--fix","--no-error-on-unmatched-pattern"],description:"ESLint fix",quiet:!0},{logger:s}),a&&(s.step("Prettier fix"),await e(".",{logger:s}),s.success("Prettier fix completed")),s.success("Fixes completed!")}catch(t){s.error(`Fix failed: ${t instanceof Error?t.message:String(t)}`,t),process.exit(1)}};

package/dist/phoenix/commands/index.d.ts

@@ -12,6 +12,7 @@ export { prepareDevelopmentEnvironment } from '../services/prepare-development-e
 export { prepareLocalEnvironment } from './prepare-local-environment-command.js';
 export { runFinishDeploymentCommand } from './finish-deployment-command.js';
 export { runDeploymentBuildEnvsCommand } from './deployment-build-envs-command.js';
+export { runDepsCommand } from './deps/index.js';
 export { runDevCommand } from './dev.js';
 export { runFixCommand } from './fix.js';
 export { runLinkCommand } from './link.js';
@@ -30,6 +31,7 @@ export { runScreenshotCommand } from './screenshot.js';
 export { runStateCommand } from './state.js';
 export { runDataCommand } from './data.js';
 export { runSceneCommand } from './scene.js';
+export { runVariantsCommand } from './variants.js';
 export { runLoginCommand } from './login.js';
 export { runLogoutCommand } from './logout.js';
 export { runDeployCommand } from './deploy.js';

package/dist/phoenix/commands/index.js

@@ -1 +1 @@
-export{runBuildCommand}from"./build.js";export{runCheckCommand}from"./check.js";export{runCleanCommand}from"./clean.js";export{runActivateDeploymentCommand}from"./activate-deployment.js";export{runCreateEnvironmentCommand}from"./create-environment.js";export{runCleanupEnvironmentCommand}from"./cleanup-environment.js";export{runListEnvironmentsCommand}from"./list-environments.js";export{runRegisterDeploymentCommand}from"./register-deployment.js";export{runPrepareDeploymentCommand}from"./prepare-deployment-command.js";export{prepareDevelopmentEnvironment}from"../services/prepare-development-environment.js";export{prepareLocalEnvironment}from"./prepare-local-environment-command.js";export{runFinishDeploymentCommand}from"./finish-deployment-command.js";export{runDeploymentBuildEnvsCommand}from"./deployment-build-envs-command.js";export{runDevCommand}from"./dev.js";export{runFixCommand}from"./fix.js";export{runLinkCommand}from"./link.js";export{runUnlinkCommand}from"./unlink.js";export{runPrepareCiCommand}from"./prepare-ci.js";export{runStoryCommand}from"./story.js";export{runStoryBuildCommand}from"./story-build.js";export{runStoryCreateCommand}from"./story-create.js";export{runStoryDevCommand}from"./story-dev.js";export{runInitCommand}from"./init.js";export{runSyncCommand}from"./sync.js";export{runChangelogCommand}from"./changelog.js";export{runDocsCommand}from"./docs.js";export{runInspectAssetsCommand}from"./inspect-assets.js";export{runScreenshotCommand}from"./screenshot.js";export{runStateCommand}from"./state.js";export{runDataCommand}from"./data.js";export{runSceneCommand}from"./scene.js";export{runLoginCommand}from"./login.js";export{runLogoutCommand}from"./logout.js";export{runDeployCommand}from"./deploy.js";export{runFeedbackCommand}from"./feedback.js";export{runExtractSourcesCommand}from"./extract-sources-command.js";
+export{runBuildCommand}from"./build.js";export{runCheckCommand}from"./check.js";export{runCleanCommand}from"./clean.js";export{runActivateDeploymentCommand}from"./activate-deployment.js";export{runCreateEnvironmentCommand}from"./create-environment.js";export{runCleanupEnvironmentCommand}from"./cleanup-environment.js";export{runListEnvironmentsCommand}from"./list-environments.js";export{runRegisterDeploymentCommand}from"./register-deployment.js";export{runPrepareDeploymentCommand}from"./prepare-deployment-command.js";export{prepareDevelopmentEnvironment}from"../services/prepare-development-environment.js";export{prepareLocalEnvironment}from"./prepare-local-environment-command.js";export{runFinishDeploymentCommand}from"./finish-deployment-command.js";export{runDeploymentBuildEnvsCommand}from"./deployment-build-envs-command.js";export{runDepsCommand}from"./deps/index.js";export{runDevCommand}from"./dev.js";export{runFixCommand}from"./fix.js";export{runLinkCommand}from"./link.js";export{runUnlinkCommand}from"./unlink.js";export{runPrepareCiCommand}from"./prepare-ci.js";export{runStoryCommand}from"./story.js";export{runStoryBuildCommand}from"./story-build.js";export{runStoryCreateCommand}from"./story-create.js";export{runStoryDevCommand}from"./story-dev.js";export{runInitCommand}from"./init.js";export{runSyncCommand}from"./sync.js";export{runChangelogCommand}from"./changelog.js";export{runDocsCommand}from"./docs.js";export{runInspectAssetsCommand}from"./inspect-assets.js";export{runScreenshotCommand}from"./screenshot.js";export{runStateCommand}from"./state.js";export{runDataCommand}from"./data.js";export{runSceneCommand}from"./scene.js";export{runVariantsCommand}from"./variants.js";export{runLoginCommand}from"./login.js";export{runLogoutCommand}from"./logout.js";export{runDeployCommand}from"./deploy.js";export{runFeedbackCommand}from"./feedback.js";export{runExtractSourcesCommand}from"./extract-sources-command.js";

package/dist/phoenix/commands/init.d.ts

@@ -6,10 +6,10 @@ export interface InitCommandProps {
 }
 /**
  * Starts a Phoenix project: writes a `package.json` that depends on this CLI's SDK version when the folder has none,
- * the starter spec and the pnpm settings the first install needs, and switches the project to the application-spec
- * pipeline. It touches no server and asks
- * nothing: the starter spec names the default project of whichever workspace the developer signs in to, and
- * everything else is generated by sync or the build.
+ * the starter spec and the pnpm settings the first install needs, adds the `dev`, `build`, `deploy`, `check` and `fix`
+ * scripts the project does not have yet, and switches the project to the application-spec pipeline. It touches no
+ * server and asks nothing: the starter spec names the default project of whichever workspace the developer signs in
+ * to, and everything else is generated by sync or the build.
  *
  * Refuses when a `spec/` folder exists, and when an existing `package.json` does not depend on the SDK.
  */

package/dist/phoenix/commands/init.js

@@ -1 +1 @@
-import{existsSync as e}from"fs";import{mkdir as n,readFile as t,writeFile as i}from"fs/promises";import{basename as o,dirname as r,join as p}from"path";import{ensureWorkspaceInstallSettings as a}from"../utils/index.js";import{starterSpecFiles as s}from"./init-starter-spec.js";let c="@salsita-ai/sdk",l=async e=>{let n=`Install the SDK first (\`pnpm add ${c}\`), then rerun \`pnpm phoenix init\`.`,i=JSON.parse(await t(e,"utf-8"));if("object"!=typeof i||null===i||Array.isArray(i))throw Error(`phoenix init could not read package.json because it is not a JSON object. ${n}`);if(!["dependencies","devDependencies"].some(e=>{let n=Reflect.get(i,e);return"object"==typeof n&&null!==n&&c in n}))throw Error(`phoenix init found no ${c} dependency in package.json. ${n}`);return{...i}},d=async e=>{for(let t of s){let o=p(e,t.path);await n(r(o),{recursive:!0}),await i(o,t.content)}},m=async(e,n)=>{let t=n.phoenix;await i(e,JSON.stringify({...n,phoenix:{..."object"==typeof t&&null!==t?t:{},applicationFlow:!0}},null,2)+"\n")};export const runInitCommand=async(t,{logger:i})=>{var r,s;let f,u=t.projectRoot??process.cwd(),h=p(u,"package.json");if(e(p(u,"spec")))throw Error("phoenix init found an existing spec/ folder. init only starts new projects, and writing a starter spec would overwrite or mix with the existing one. To update an existing project, run `pnpm phoenix sync`; to start over, run init in an empty project folder.");let w=e(h)?await l(h):(r=u,s=t.sdkVersion,{name:(f=o(r).toLowerCase().replace(/[^a-z0-9._-]+/g,"-").replace(/^[._-]+|[-]+$/g,"")).length>0?f:"phoenix-configurator",private:!0,type:"module",dependencies:{[c]:s},devDependencies:{"@lingui/cli":"5.9.5","@lingui/swc-plugin":"5.11.0"}});i.step(`Writing the starter project to ${u}`),await n(u,{recursive:!0}),await d(u),await m(h,w),a(u),i.success(`Phoenix project created in ${u}.`),i.info("\nNext steps, in the project folder:\n  pnpm install\n  pnpm phoenix sync\n  pnpm phoenix login <workspace>\n  pnpm phoenix dev\n  pnpm phoenix deploy\n\nDeveloping against a Studio development environment instead? Paste its .env block into .env before phoenix dev.")};
+import{existsSync as e}from"fs";import{mkdir as n,readFile as t,writeFile as i}from"fs/promises";import{basename as o,dirname as r,join as p}from"path";import{ensureWorkspaceInstallSettings as s}from"../utils/index.js";import{starterSpecFiles as a}from"./init-starter-spec.js";let c="@salsita-ai/sdk",l={dev:"phoenix dev",build:"phoenix build",deploy:"phoenix deploy",check:"phoenix check",fix:"phoenix fix"},d=async e=>{let n=`Install the SDK first (\`pnpm add ${c}\`), then rerun \`pnpm phoenix init\`.`,i=JSON.parse(await t(e,"utf-8"));if("object"!=typeof i||null===i||Array.isArray(i))throw Error(`phoenix init could not read package.json because it is not a JSON object. ${n}`);if(!["dependencies","devDependencies"].some(e=>{let n=Reflect.get(i,e);return"object"==typeof n&&null!==n&&c in n}))throw Error(`phoenix init found no ${c} dependency in package.json. ${n}`);return{...i}},h=async e=>{for(let t of a){let o=p(e,t.path);await n(r(o),{recursive:!0}),await i(o,t.content)}},f=async(e,n)=>{let t=n.phoenix,o=n.scripts,r="object"==typeof o&&null!==o?o:{},p=Object.fromEntries(Object.entries(l).filter(([e])=>!(e in r)));await i(e,JSON.stringify({...n,scripts:{...r,...p},phoenix:{..."object"==typeof t&&null!==t?t:{},applicationFlow:!0}},null,2)+"\n")};export const runInitCommand=async(t,{logger:i})=>{var r,a;let u,m=t.projectRoot??process.cwd(),x=p(m,"package.json");if(e(p(m,"spec")))throw Error("phoenix init found an existing spec/ folder. init only starts new projects, and writing a starter spec would overwrite or mix with the existing one. To update an existing project, run `pnpm phoenix sync`; to start over, run init in an empty project folder.");let w=e(x)?await d(x):(r=m,a=t.sdkVersion,{name:(u=o(r).toLowerCase().replace(/[^a-z0-9._-]+/g,"-").replace(/^[._-]+|[-]+$/g,"")).length>0?u:"phoenix-configurator",private:!0,type:"module",scripts:l,dependencies:{[c]:a},devDependencies:{"@lingui/cli":"5.9.5","@lingui/swc-plugin":"5.11.0"}});i.step(`Writing the starter project to ${m}`),await n(m,{recursive:!0}),await h(m),await f(x,w),s(m),i.success(`Phoenix project created in ${m}.`),i.info("\nNext steps, in the project folder:\n  pnpm install\n  pnpm phoenix sync\n  pnpm phoenix login <workspace>\n  pnpm phoenix dev\n  pnpm phoenix deploy\n\nDeveloping against a Studio development environment instead? Paste its .env block into .env before phoenix dev.")};

package/dist/phoenix/commands/prepare-deployment-command.js

@@ -1,2 +1,2 @@
-import{writeFile as e}from"fs/promises";import{createApiBaseClient as a}from"#package/client";import{resolveApplicationSpecDeploymentData as r}from"../application-spec/index.js";import{formatEnvContent as t,formatEnvLine as i}from"../utils/index.js";export const runPrepareDeploymentCommand=async(s,n)=>{let{logger:o}=n;try{o.step("Preparing deployment");let{apiKey:n,projectKey:l,projectSlug:p,projectRef:c,projectSha:m,environmentSlug:d,outFile:h,skipUpload:u,overrideSchema:f,uploadLinksFile:g,serverUrl:v}=s;o.info(`Preparing deployment for project "${p}", environment "${d}"`);let b=a(v);o.debug(`Using server URL: ${v}`);let y=await r({skipUpload:u,logger:o});if(y.assistant){let{sdl:e,prompt:a,instructions:r}=y.assistant,t=a.length+e.length+(r?.length??0);o.info(`Assistant GraphQL schema:
-${e}`),o.info(`Assistant prompt of this deployment (generated prompt, schema and instructions): ${t} characters`)}o.info("Preparing deployment on server...");let{data:w,error:F}=await b.POST("/environments/prepare",{body:{projectSlug:p,environmentSlug:d,applicationVersion:y.applicationVersion,projectRef:c,projectSha:m,publishedDataHash:y.publishedDataHash,useAuthHook:y.useAuthHook,overrideSchema:f,configurationSchema:{version:y.schemaVersion,schema:y.schema},adminConfigurationSchema:y.adminSchema?{schema:y.adminSchema,version:y.adminSchemaVersion}:void 0,chat:y.chat,embeddings:y.embeddings,assistant:y.assistant,acl:{canCreate:y.aclCanCreate},privateFiles:[...y.assets.privateFilePaths],publicFiles:[...y.assets.publicFilePaths]},headers:{"x-api-key":n,"x-project-key":l,"x-project-slug":p}});if(F)throw Error(`Failed to prepare deployment with server: ${F.message}`);if(!w)throw Error("No data returned from server");o.debug("Deployment prepared on server");let{baseDomain:S,isCustomDomain:P}=w,U=w.environmentVariables,k=w.privateUploadUrls,$=w.publicUploadUrls;if(!U||!k||!$)throw Error("Incomplete data returned from server");try{let a=[t(U),i("BASE_DOMAIN",String(S)),i("IS_CUSTOM_DOMAIN",String(P))].join("\n");await e(h,a+"\n"),o.debug(`Environment variables written to ${h}`)}catch(e){throw Error("Failed to write environment variables to file")}try{if(u)await e(g,JSON.stringify({privateFiles:[],publicFiles:[]},null,2)),o.debug("Upload links file cleared (upload was skipped)");else{let a={privateFiles:[...y.assets.privateFilesFullPaths].map(e=>({localPath:e,uploadUrl:k[e.replace(/^assets\/private\//,"")]})),publicFiles:[...y.assets.publicFilesFullPaths].map(e=>({localPath:e,uploadUrl:$[e.replace(/^assets\/public\//,"")]}))};await e(g,JSON.stringify(a,null,2)),o.debug(`Upload links written to ${g}`),o.info('Run "finish" command to upload files and activate the deployment')}}catch(e){throw Error("Failed to write upload links to file")}o.success("Deployment prepared successfully!")}catch(e){o.error(`Deployment preparation failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};
+import{writeFile as e}from"fs/promises";import{createApiBaseClient as t}from"#package/client";import{resolveApplicationSpecDeploymentData as a}from"../application-spec/index.js";import{formatEnvContent as r,formatEnvLine as i}from"../utils/index.js";export const runPrepareDeploymentCommand=async(s,n)=>{let{logger:o}=n;try{o.step("Preparing deployment");let{apiKey:n,projectKey:l,projectSlug:p,projectRef:c,projectSha:m,environmentSlug:d,outFile:h,skipUpload:u,overrideSchema:f,uploadLinksFile:g,serverUrl:v}=s;o.info(`Preparing deployment for project "${p}", environment "${d}"`);let b=t(v);o.debug(`Using server URL: ${v}`);let y=await a({skipUpload:u,logger:o});if(y.assistantSetup){let{sdl:e,prompt:t,instructions:a}=y.assistantSetup,r=t.length+e.length+(a?.length??0);o.info(`Assistant GraphQL schema:
+${e}`),o.info(`Assistant prompt of this deployment (generated prompt, schema and instructions): ${r} characters`)}o.info("Preparing deployment on server...");let{data:w,error:S}=await b.POST("/environments/prepare",{body:{projectSlug:p,environmentSlug:d,applicationVersion:y.applicationVersion,projectRef:c,projectSha:m,publishedDataHash:y.publishedDataHash,useAuthHook:y.useAuthHook,overrideSchema:f,configurationSchema:{version:y.schemaVersion,schema:y.schema},adminConfigurationSchema:y.adminSchema?{schema:y.adminSchema,version:y.adminSchemaVersion}:void 0,chat:y.chat,embeddings:y.embeddings,...y.assistant?{assistant:!0}:{},acl:{canCreate:y.aclCanCreate},privateFiles:[...y.assets.privateFilePaths],publicFiles:[...y.assets.publicFilePaths]},headers:{"x-api-key":n,"x-project-key":l,"x-project-slug":p}});if(S)throw Error(`Failed to prepare deployment with server: ${S.message}`);if(!w)throw Error("No data returned from server");o.debug("Deployment prepared on server");let{baseDomain:F,isCustomDomain:P}=w,U=w.environmentVariables,k=w.privateUploadUrls,$=w.publicUploadUrls;if(!U||!k||!$)throw Error("Incomplete data returned from server");try{let t=[r(U),i("BASE_DOMAIN",String(F)),i("IS_CUSTOM_DOMAIN",String(P))].join("\n");await e(h,t+"\n"),o.debug(`Environment variables written to ${h}`)}catch(e){throw Error("Failed to write environment variables to file")}try{if(u)await e(g,JSON.stringify({privateFiles:[],publicFiles:[]},null,2)),o.debug("Upload links file cleared (upload was skipped)");else{let t={privateFiles:[...y.assets.privateFilesFullPaths].map(e=>({localPath:e,uploadUrl:k[e.replace(/^assets\/private\//,"")]})),publicFiles:[...y.assets.publicFilesFullPaths].map(e=>({localPath:e,uploadUrl:$[e.replace(/^assets\/public\//,"")]}))};await e(g,JSON.stringify(t,null,2)),o.debug(`Upload links written to ${g}`),o.info('Run "finish" command to upload files and activate the deployment')}}catch(e){throw Error("Failed to write upload links to file")}o.success("Deployment prepared successfully!")}catch(e){o.error(`Deployment preparation failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};

package/dist/phoenix/commands/prepare-local-environment-command.js

@@ -1 +1 @@
-import{writeFile as e}from"fs/promises";import{createApiBaseClient as r}from"#package/client";import{resolveApplicationSpecDeploymentData as t}from"../application-spec/index.js";import{formatEnvContent as i,uploadFilesWithPresignedUrls as a}from"../utils/index.js";export const prepareLocalEnvironment=async(o,s)=>{let{logger:n}=s;n.step("Preparing local environment");let{projectKey:l,projectSlug:p,outFile:c,skipUpload:d,overrideSchema:m,serverUrl:h,lambdaUrl:f,environmentSlug:v,apiKey:u}=o;n.info(`Preparing local environment for project "${p}", environment "${v}"`);let y=r(h);n.debug(`Using server URL: ${h}`);let b=await t({skipUpload:d,logger:n});n.info("Preparing a local environment and deployment on the server...");let{data:g,error:w}=await y.POST("/environments/prepare",{body:{projectSlug:p,environmentSlug:v,applicationVersion:b.applicationVersion,publishedDataHash:b.publishedDataHash,useAuthHook:b.useAuthHook,overrideSchema:m,configurationSchema:{version:b.schemaVersion,schema:b.schema},adminConfigurationSchema:b.adminSchema?{schema:b.adminSchema,version:b.adminSchemaVersion}:void 0,chat:b.chat,embeddings:b.embeddings,assistant:b.assistant,acl:{canCreate:b.aclCanCreate},privateFiles:[...b.assets.privateFilePaths],publicFiles:[...b.assets.publicFilePaths]},headers:{"x-api-key":u,"x-project-key":l,"x-project-slug":p}});if(w)throw Error(`Failed to prepare deployment with server: ${w.message}`);if(!g)throw Error("No data returned from server");n.debug("Deployment prepared on server");let E=g.environmentVariables,F=g.privateUploadUrls,P=g.publicUploadUrls,$=E?.DEPLOYMENT_ID;if(!E||!F||!P)throw Error("Incomplete data returned from server");if(!$)throw Error("No deployment ID returned from server");try{await e(c,i(E)+"\n"),n.debug(`Environment variables written to ${c}`)}catch(e){throw Error(`Failed to write environment variables to file at ${c}, please verify you have write permissions to this location.`)}if(d)n.debug("Skipping file upload");else{n.info("Uploading files to S3...");let e={privateFiles:[...b.assets.privateFilesFullPaths].map(e=>{let r=e.replace("assets/private/",""),t=F[r];if(!t)throw Error(`No upload URL provided for private file ${r}, the server did not return a presigned URL for this file, please verify the file exists in the assets/private directory.`);return{localPath:e,uploadUrl:t}}),publicFiles:[...b.assets.publicFilesFullPaths].map(e=>{let r=e.replace("assets/public/",""),t=P[r];if(!t)throw Error(`No upload URL provided for public file ${r}, the server did not return a presigned URL for this file, please verify the file exists in the assets/public directory.`);return{localPath:e,uploadUrl:t}})};await a(e,{logger:n})}n.info("Activating deployment...");let{error:U}=await y.POST("/deployments/{deploymentId}/activate",{params:{path:{deploymentId:$}},headers:{"x-project-key":l,"x-project-slug":p,"x-api-key":u},body:{lambdaUrl:f}});if(U)throw Error(`Failed to activate deployment with server: ${U.message}`);n.info(`Project: ${p}`),n.info(`Environment: ${v}`),n.info(`Deployment ID: ${$}`),n.info(`Lambda URL: ${f}`),n.success("Local environment prepared successfully!")};
+import{writeFile as e}from"fs/promises";import{createApiBaseClient as r}from"#package/client";import{resolveApplicationSpecDeploymentData as t}from"../application-spec/index.js";import{formatEnvContent as i,uploadFilesWithPresignedUrls as a}from"../utils/index.js";export const prepareLocalEnvironment=async(o,s)=>{let{logger:n}=s;n.step("Preparing local environment");let{projectKey:l,projectSlug:p,outFile:c,skipUpload:d,overrideSchema:m,serverUrl:h,lambdaUrl:f,environmentSlug:v,apiKey:u}=o;n.info(`Preparing local environment for project "${p}", environment "${v}"`);let y=r(h);n.debug(`Using server URL: ${h}`);let b=await t({skipUpload:d,logger:n});n.info("Preparing a local environment and deployment on the server...");let{data:g,error:w}=await y.POST("/environments/prepare",{body:{projectSlug:p,environmentSlug:v,applicationVersion:b.applicationVersion,publishedDataHash:b.publishedDataHash,useAuthHook:b.useAuthHook,overrideSchema:m,configurationSchema:{version:b.schemaVersion,schema:b.schema},adminConfigurationSchema:b.adminSchema?{schema:b.adminSchema,version:b.adminSchemaVersion}:void 0,chat:b.chat,embeddings:b.embeddings,...b.assistant?{assistant:!0}:{},acl:{canCreate:b.aclCanCreate},privateFiles:[...b.assets.privateFilePaths],publicFiles:[...b.assets.publicFilePaths]},headers:{"x-api-key":u,"x-project-key":l,"x-project-slug":p}});if(w)throw Error(`Failed to prepare deployment with server: ${w.message}`);if(!g)throw Error("No data returned from server");n.debug("Deployment prepared on server");let E=g.environmentVariables,F=g.privateUploadUrls,P=g.publicUploadUrls,$=E?.DEPLOYMENT_ID;if(!E||!F||!P)throw Error("Incomplete data returned from server");if(!$)throw Error("No deployment ID returned from server");try{await e(c,i(E)+"\n"),n.debug(`Environment variables written to ${c}`)}catch(e){throw Error(`Failed to write environment variables to file at ${c}, please verify you have write permissions to this location.`)}if(d)n.debug("Skipping file upload");else{n.info("Uploading files to S3...");let e={privateFiles:[...b.assets.privateFilesFullPaths].map(e=>{let r=e.replace("assets/private/",""),t=F[r];if(!t)throw Error(`No upload URL provided for private file ${r}, the server did not return a presigned URL for this file, please verify the file exists in the assets/private directory.`);return{localPath:e,uploadUrl:t}}),publicFiles:[...b.assets.publicFilesFullPaths].map(e=>{let r=e.replace("assets/public/",""),t=P[r];if(!t)throw Error(`No upload URL provided for public file ${r}, the server did not return a presigned URL for this file, please verify the file exists in the assets/public directory.`);return{localPath:e,uploadUrl:t}})};await a(e,{logger:n})}n.info("Activating deployment...");let{error:U}=await y.POST("/deployments/{deploymentId}/activate",{params:{path:{deploymentId:$}},headers:{"x-project-key":l,"x-project-slug":p,"x-api-key":u},body:{lambdaUrl:f}});if(U)throw Error(`Failed to activate deployment with server: ${U.message}`);n.info(`Project: ${p}`),n.info(`Environment: ${v}`),n.info(`Deployment ID: ${$}`),n.info(`Lambda URL: ${f}`),n.success("Local environment prepared successfully!")};

package/dist/phoenix/commands/prettier.js

@@ -1 +1 @@
-import{readFile as t,writeFile as e}from"fs/promises";import{globby as o}from"globby";import{resolve as r}from"path";import*as i from"prettier";let a=["**/node_modules/**","**/dist/**","**/.git/**","**/webhooks/index.ts`","**/frontend-configurator.ts`","**/frontend-admin.ts`","**/frontend-embedded-admin.ts`","pnpm-lock.yaml",".linguirc"];export const formatFiles=async(n,f)=>{let{logger:l}=f,s=await o("."===n?"**/*":n,{gitignore:!0,ignore:a}),c=0;for(let o of s)try{let a=r(o),n=await t(a,"utf-8"),f=await i.resolveConfig(a);if((await i.getFileInfo(a)).ignored)continue;let l=await i.format(n,{...f,filepath:a});l!==n&&(await e(a,l,"utf-8"),c++)}catch(t){}c>0&&l.info(`Formatted ${c} file${1!==c?"s":""}`)};export const checkFiles=async(e,n)=>{let{logger:f}=n,l=await o("."===e?"**/*":e,{gitignore:!0,ignore:a}),s=[];for(let e of l)try{let o=r(e),a=await t(o,"utf-8"),n=await i.resolveConfig(o);if((await i.getFileInfo(o)).ignored)continue;await i.check(a,{...n,filepath:o})||s.push(e)}catch(t){}return!(s.length>0)||(f.error(`Found ${s.length} unformatted file${1!==s.length?"s":""}:`),s.forEach(t=>{console.error(`  - ${t}`)}),!1)};
+import{readFile as t,writeFile as e}from"fs/promises";import{globby as o}from"globby";import{resolve as i}from"path";import*as r from"prettier";let a=["**/node_modules/**","**/dist/**","**/.git/**","**/.phoenix/**","**/locales/*/*.ts","pnpm-lock.yaml",".linguirc"];export const formatFiles=async(n,l)=>{let{logger:f}=l,s=await o("."===n?"**/*":n,{gitignore:!0,ignore:a}),c=0;for(let o of s)try{let a=i(o),n=await t(a,"utf-8"),l=await r.resolveConfig(a);if((await r.getFileInfo(a)).ignored)continue;let f=await r.format(n,{...l,filepath:a});f!==n&&(await e(a,f,"utf-8"),c++)}catch(t){}c>0&&f.info(`Formatted ${c} file${1!==c?"s":""}`)};export const checkFiles=async(e,n)=>{let{logger:l}=n,f=await o("."===e?"**/*":e,{gitignore:!0,ignore:a}),s=[];for(let e of f)try{let o=i(e),a=await t(o,"utf-8"),n=await r.resolveConfig(o);if((await r.getFileInfo(o)).ignored)continue;await r.check(a,{...n,filepath:o})||s.push(e)}catch(t){}return!(s.length>0)||(l.error(`Found ${s.length} unformatted file${1!==s.length?"s":""}:`),s.forEach(t=>{console.error(`  - ${t}`)}),!1)};

package/dist/phoenix/commands/story-dev.js

@@ -1,2 +1,2 @@
-import{globby as e}from"globby";import{rmSync as r}from"node:fs";import{mkdir as o,writeFile as t}from"node:fs/promises";import{dirname as s,resolve as i}from"node:path";import{startEditorServer as a}from"../editor-server/index.js";import{ApplicationSpecStoryWatcher as n}from"../services/application-spec-story-watcher.js";import{STORY_DEV_MARKER_PATH as l,readActiveStoryDevMarker as c}from"../services/index.js";import{MockTemplateWatcher as d}from"../services/mock-template-watcher.js";import{PhoenixPubSub as f}from"../services/phoenix-pubsub.js";import{resolveGlobToDirectories as p}from"./resolve-story-directories.js";import{runStoryBuildCommand as g}from"./story-build.js";let m=async(r,o)=>{let t=o?i(process.cwd(),o):s(r),a=new Set([r,...(await e(`*/${l}`,{cwd:t,absolute:!0})).map(e=>s(s(e)))]);return(await Promise.all([...a].map(c))).find(e=>null!==e)??null},w=async(e,r)=>{let a=i(e,l),n={projectRoot:e,pid:process.pid,port:r};return await o(s(a),{recursive:!0}),await t(a,`${JSON.stringify(n)}
-`),a},u=async(e,o)=>{let t=await p(e.folder,e.baseDir),[s]=t,i=e.editorWsPort??3120;if(!s||1!==t.length)throw Error(`Story dev requires exactly one existing story folder, but "${e.folder}" resolved ${t.length}. Pass one concrete folder and check the base directory.`);let l=await m(s,e.baseDir);if(l)throw Error(`Story dev is already running for "${l.projectRoot}" (PID ${l.pid}) on port ${l.port}. Stop that process before starting another story.`);let c=await w(s,i),u=()=>r(c,{force:!0});process.once("exit",u);let y=new f,h=null,b=null,S=null,v=!1,$=async()=>{if(!v){for(let e of(v=!0,process.off("exit",u),[{name:"story source watcher",close:()=>S?.close()},{name:"mock-template watcher",close:()=>b?.close()},{name:"editor server",close:()=>h?.close()}]))try{await e.close()}catch(r){o.logger.warn(`Failed to close the story-dev ${e.name}: ${r instanceof Error?r.message:String(r)}. The process will continue shutting down.`)}r(c,{force:!0})}};try{return o.logger.step(`Building application-spec story in ${s}`),await g({folder:s,baseDir:e.baseDir},o),h=a({port:i,projectRoot:s,pubsub:y,logger:o.logger,storyMode:!0}),await h.ready,(b=new d({projectRoot:s,pubsub:y,logger:o.logger})).start(),(S=new n({projectRoot:s,pubsub:y,logger:o.logger})).start(),o.logger.success(`Story dev is running for ${s}`),o.logger.info(`Editor WebSocket: ws://localhost:${i}`),o.logger.info("Source changes update the editor without regenerating Storybook files."),{markerPath:c,close:$}}catch(e){throw await $(),e}};export const runStoryDevCommand=async(e,r)=>{let o;if(o=e.folder,/[*?[\]{}()!]/.test(o))throw Error(`Story dev accepts one concrete story folder, but "${e.folder}" contains glob syntax. Pass a folder name without wildcards.`);let t=await u(e,r),s=null,i=new Promise(e=>{s=e}),a=()=>s?.();process.once("SIGINT",a),process.once("SIGTERM",a),e.shutdownSignal?.addEventListener("abort",a,{once:!0}),e.shutdownSignal?.aborted&&a();try{await i}finally{process.off("SIGINT",a),process.off("SIGTERM",a),e.shutdownSignal?.removeEventListener("abort",a),await t.close()}};
+import{globby as e}from"globby";import{rmSync as r}from"node:fs";import{mkdir as o,writeFile as t}from"node:fs/promises";import{dirname as s,resolve as i}from"node:path";import{startEditorServer as a}from"../editor-server/index.js";import{ApplicationSpecStoryWatcher as n}from"../services/application-spec-story-watcher.js";import{STORY_DEV_MARKER_PATH as l,readActiveStoryDevMarker as c}from"../services/index.js";import{MockTemplateWatcher as p}from"../services/mock-template-watcher.js";import{PhoenixApplication as d}from"../services/phoenix-application.js";import{PhoenixPubSub as f}from"../services/phoenix-pubsub.js";import{PhoenixStore as m}from"../services/phoenix-store.js";import{resolveGlobToDirectories as w}from"./resolve-story-directories.js";import{runStoryBuildCommand as g}from"./story-build.js";let u=async(r,o)=>{let t=o?i(process.cwd(),o):s(r),a=new Set([r,...(await e(`*/${l}`,{cwd:t,absolute:!0})).map(e=>s(s(e)))]);return(await Promise.all([...a].map(c))).find(e=>null!==e)??null},y=async(e,r)=>{let a=i(e,l),n={projectRoot:e,pid:process.pid,port:r};return await o(s(a),{recursive:!0}),await t(a,`${JSON.stringify(n)}
+`),a},h=async(e,o)=>{let t=await w(e.folder,e.baseDir),[s]=t,i=e.editorWsPort??3120;if(!s||1!==t.length)throw Error(`Story dev requires exactly one existing story folder, but "${e.folder}" resolved ${t.length}. Pass one concrete folder and check the base directory.`);let l=await u(s,e.baseDir);if(l)throw Error(`Story dev is already running for "${l.projectRoot}" (PID ${l.pid}) on port ${l.port}. Stop that process before starting another story.`);let c=await y(s,i),h=()=>r(c,{force:!0});process.once("exit",h);let v=new f,b=null,S=null,$=null,x=!1,j=async()=>{if(!x){for(let e of(x=!0,process.off("exit",h),[{name:"story source watcher",close:()=>$?.close()},{name:"mock-template watcher",close:()=>S?.close()},{name:"editor server",close:()=>b?.close()}]))try{await e.close()}catch(r){o.logger.warn(`Failed to close the story-dev ${e.name}: ${r instanceof Error?r.message:String(r)}. The process will continue shutting down.`)}r(c,{force:!0})}};try{return o.logger.step(`Building application-spec story in ${s}`),await g({folder:s,baseDir:e.baseDir},o),b=a({port:i,projectRoot:s,application:new d({store:new m,pubsub:v,variantPreviews:void 0}),logger:o.logger,storyMode:!0}),await b.ready,(S=new p({projectRoot:s,pubsub:v,logger:o.logger})).start(),($=new n({projectRoot:s,pubsub:v,logger:o.logger})).start(),o.logger.success(`Story dev is running for ${s}`),o.logger.info(`Editor WebSocket: ws://localhost:${i}`),o.logger.info("Source changes update the editor without regenerating Storybook files."),{markerPath:c,close:j}}catch(e){throw await j(),e}};export const runStoryDevCommand=async(e,r)=>{let o;if(o=e.folder,/[*?[\]{}()!]/.test(o))throw Error(`Story dev accepts one concrete story folder, but "${e.folder}" contains glob syntax. Pass a folder name without wildcards.`);let t=await h(e,r),s=null,i=new Promise(e=>{s=e}),a=()=>s?.();process.once("SIGINT",a),process.once("SIGTERM",a),e.shutdownSignal?.addEventListener("abort",a,{once:!0}),e.shutdownSignal?.aborted&&a();try{await i}finally{process.off("SIGINT",a),process.off("SIGTERM",a),e.shutdownSignal?.removeEventListener("abort",a),await t.close()}};

package/dist/phoenix/commands/variants.d.ts

@@ -0,0 +1,35 @@
+import type { VariantPreviewOption } from '../services/phoenix-store.js';
+import type { CommandContext } from './types.js';
+export interface VariantsCommandProps {
+    /** Folder of the option set; only `close` works without one. */
+    readonly directory: string | undefined;
+    readonly title: string | undefined;
+    readonly description: string | undefined;
+    /** Seconds to wait for the answer. */
+    readonly timeout: number | undefined;
+    readonly keep: boolean | undefined;
+    readonly close: boolean | undefined;
+    readonly port: string;
+}
+/** One folder of options below `.phoenix/variants/`, as the editor is asked to show it. */
+export interface VariantSet {
+    /** Absolute path of the folder; the command removes it once the builder has answered. */
+    readonly directory: string;
+    /** Absolute path of `.phoenix/variants/`, removed together with the last set in it. */
+    readonly variantsRoot: string;
+    readonly options: readonly VariantPreviewOption[];
+}
+/**
+ * Reads scripts and standalone HTML pages in file-name order. Other files are helpers the options share.
+ *
+ * @throws when the folder is not a variant set the dev server can show
+ */
+export declare const readVariantSet: (props: {
+    readonly projectRoot: string;
+    readonly directory: string;
+}) => VariantSet;
+/**
+ * Shows the options of one `.phoenix/variants/<name>/` folder over the configurator of a running
+ * `phoenix dev`, waits for the builder to answer, prints the answer as JSON and removes the folder.
+ */
+export declare const runVariantsCommand: (props: VariantsCommandProps, context: CommandContext) => Promise<void>;

package/dist/phoenix/commands/variants.js

@@ -0,0 +1 @@
+import{createTRPCClient as e,createWSClient as t,wsLink as o}from"@trpc/client";import{existsSync as r,readFileSync as i,readdirSync as n,rmSync as a,statSync as s}from"fs";import{isAbsolute as l,join as c,relative as p,resolve as d,sep as h}from"path";import f from"ws";import{toPosixPath as w}from"../utils/path.js";let m=".phoenix",u="variants",v=".variant.js",g=".html",y={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&#39;":"'"},$=e=>{let t=e?.trim();return""===t?void 0:t},b=e=>$(e?.replace(/&(?:amp|lt|gt|quot|#39);/g,e=>y[e]??e)),C=(e,t)=>{let o=e.match(RegExp(`export\\s+const\\s+${t}\\s*=\\s*(['"\`])((?:\\\\.|(?!\\1).)*)\\1`))?.[2];return $(o?.replace(/\\(.)/g,"$1"))};export const readVariantSet=e=>{let t=d(e.projectRoot,m),o=c(t,u),a=d(e.projectRoot,e.directory),f=p(o,a),y=`${m}/${u}/<name>/`;if(""===f||".."===f||f.startsWith(`..${h}`)||l(f))throw Error(`Cannot preview ${e.directory}: the dev server only shows options from a folder of their own below ${m}/${u}/. Write the option files to ${y} and pass that folder`);if(!r(a)||!s(a).isDirectory())throw Error(`Cannot preview ${e.directory}: there is no such folder. Write one ${v} or ${g} file per option to ${y} first`);let $=n(a),E=Math.round(Math.max(0,...$.map(e=>s(c(a,e)).mtimeMs))),x=$.filter(e=>e.endsWith(v)||e.endsWith(g)).sort().map(e=>(e=>{let{webRoot:t,directory:o,name:r,version:n}=e,a=c(o,r),s=i(a,"utf8"),l=`/${w(p(t,a)).split("/").map(encodeURIComponent).join("/")}`,d=r.endsWith(v),h=r.slice(0,-(d?v:g).length),f=s.match(/<meta\b[^>]*\bname=(["'])description\1[^>]*>/i)?.[0];return{id:h,kind:d?"script":"page",label:(d?C(s,"title"):b(s.match(/<title[^>]*>([^<]*)<\/title>/i)?.[1]))??h,description:(d?C(s,"description"):b(f?.match(/\bcontent=(["'])(.*?)\1/i)?.[2]))??"",url:`${l}?t=${n}`}})({webRoot:t,directory:a,name:e,version:E}));if(0===x.length)throw Error(`Cannot preview ${e.directory}: it holds no ${v} or ${g} file, so there is no option to show. Write one file per option; any other file is a helper the options share`);let R=x.find((e,t)=>x.findIndex(t=>t.id===e.id)!==t);if(R)throw Error(`Cannot preview ${e.directory}: two options are named "${R.id}", and the answer names an option by its file name without the suffix. Rename one of the files`);return{directory:a,variantsRoot:o,options:x}};let E=r=>{let i=t({url:`ws://localhost:${r}`,WebSocket:f});return{wsClient:i,client:e({links:[o({client:i})]})}},x=e=>{console.log(JSON.stringify(e,null,2))},R=async e=>{let{wsClient:t,client:o}=E(e);try{let{closed:e}=await o.closeVariantPreview.mutate();x({status:"closed",message:e?"The open preview was closed.":"No preview was open."})}finally{await t.close()}},S=async(e,t,o,i)=>{let{wsClient:s,client:l}=E(t.port);try{let s=await l.previewVariants.mutate({title:t.title??"Which option do you prefer?",description:t.description??"",variants:[...e.options],timeoutMs:o});if("waiting"===s.status)return void x({status:"waiting",message:"The preview is still open and nothing was picked yet. Run the same command again to keep waiting."});if("closed"===s.status)return void x({status:"closed",message:"The preview was closed before an answer was given. The option folder is kept."});await l.claimVariantChoice.mutate({requestId:s.requestId});let c=e.options.find(e=>e.id===s.choice);if(x({status:"chosen",choice:s.choice,label:c?.label??"Original"}),!t.keep)try{a(e.directory,{recursive:!0,force:!0}),r(e.variantsRoot)&&0===n(e.variantsRoot).length&&a(e.variantsRoot,{recursive:!0,force:!0})}catch(t){i.logger.warn(`Could not remove ${e.directory} after the answer: ${t instanceof Error?t.message:String(t)}. Remove the folder yourself`)}}finally{await s.close()}};export const runVariantsCommand=async(e,t)=>{let{logger:o}=t;try{if(e.close)return void await R(e.port);if(void 0===e.directory)throw Error(`Cannot preview without a folder: the options to show are read from it. Pass ${m}/${u}/<name>/, or --close to close the open preview`);let o=(e=>{let t=Math.round((e??540)*1e3);if(!Number.isFinite(t)||t<=0)throw Error(`Cannot wait for ${e} seconds: --timeout is how long the command waits for the answer. Pass a positive number of seconds`);if(t>0x7fffffff)throw Error(`Cannot wait for ${e} seconds: a wait is at most ${Math.floor(2147483.647)} seconds. Pass a smaller --timeout and run the command again while it answers "waiting"`);return t})(e.timeout),r=readVariantSet({projectRoot:process.cwd(),directory:e.directory});await S(r,e,o,t)}catch(e){o.error((e=>{let t;if(!(e instanceof Error))return`Variant preview failed: ${String(e)}`;let o=e.cause;return null!=o&&"object"==typeof o&&"code"in o&&"ECONNREFUSED"===o.code?"Dev server not running. Start with `phoenix dev`":"object"==typeof(t="data"in e?e.data:void 0)&&null!==t&&"code"in t&&"NOT_FOUND"===t.code?"Cannot preview: the dev server that is running has no variant previews, because it runs the legacy pipeline or an older SDK. Variant previews need `phoenix dev` of a project on the application-spec pipeline, started with this SDK version":e.message})(e)),process.exit(1)}};

package/dist/phoenix/editor-server/commands-router.d.ts

@@ -1,8 +1,10 @@
 import { type LogEntry } from '../services/log-bus.js';
 import type { BrowserConsoleEvent, DataRequest, SceneRequest, ScreenshotRequest, StateRequest } from '../services/phoenix-pubsub.js';
+import type { VariantPreviewRequest } from '../services/phoenix-store.js';
 import type { TunnelEvent } from '../services/webhook-tunnel-monitor.js';
+import { type Context } from './trpc.js';
 export declare const commandsRouter: import("@trpc/server").TRPCBuiltRouter<{
-    ctx: import("./trpc.js").Context;
+    ctx: Context;
     meta: object;
     errorShape: import("@trpc/server").TRPCDefaultErrorShape;
     transformer: false;
@@ -167,4 +169,69 @@ export declare const commandsRouter: import("@trpc/server").TRPCBuiltRouter<{
         output: void;
         meta: object;
     }>;
+    previewVariants: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            title: string;
+            description: string;
+            variants: {
+                id: string;
+                kind: "page" | "script";
+                label: string;
+                description: string;
+                url: string;
+            }[];
+            timeoutMs: number;
+        };
+        output: import("../services/variant-preview-service.js").VariantPreviewOutcome;
+        meta: object;
+    }>;
+    onVariantPreview: import("@trpc/server/unstable-core-do-not-import").LegacyObservableSubscriptionProcedure<{
+        input: void;
+        output: VariantPreviewRequest | null;
+        meta: object;
+    }>;
+    getVariantBaseline: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            requestId: string;
+        };
+        output: {
+            readonly files: readonly import("../services/variant-file-session.js").VariantFileEdit[];
+            readonly choice: string | null;
+        };
+        meta: object;
+    }>;
+    applyVariantFiles: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            requestId: string;
+            choice: string | null;
+            files: {
+                fileName: string;
+                content: string | null;
+            }[];
+        };
+        output: void;
+        meta: object;
+    }>;
+    submitVariantChoice: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            requestId: string;
+            choice: string | null;
+        };
+        output: void;
+        meta: object;
+    }>;
+    closeVariantPreview: import("@trpc/server").TRPCMutationProcedure<{
+        input: void;
+        output: {
+            readonly closed: boolean;
+        };
+        meta: object;
+    }>;
+    claimVariantChoice: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            requestId: string;
+        };
+        output: void;
+        meta: object;
+    }>;
 }>>;

package/dist/phoenix/editor-server/commands-router.js

@@ -1 +1 @@
-import{observable as e}from"@trpc/server/observable";import{writeFile as t}from"fs/promises";import{resolve as r}from"path";import{filter as s,firstValueFrom as o,timeout as n}from"rxjs";import{z as u}from"zod";import{LOG_STREAMS as i}from"../services/log-bus.js";import{publicProcedure as a,router as b}from"./trpc.js";let c=u.enum(["all",...i]);export const commandsRouter=b({getLogs:a.input(u.object({stream:c,beforeSeq:u.number().int().positive().optional(),limit:u.number().int().positive().max(500).default(200)})).query(({input:e,ctx:t})=>{if(!t.logBus)return{entries:[],hasMore:!1,counts:null};let r=t.logBus.query(e);return{entries:r.entries,hasMore:r.hasMore,counts:t.logBus.allCounts()}}),onLog:a.subscription(({ctx:t})=>e(e=>t.logBus?t.logBus.subscribe(t=>{e.next(t)}):()=>{})),getTunnelState:a.query(({ctx:e})=>e.tunnelMonitor?{state:e.tunnelMonitor.state(),entries:e.tunnelMonitor.summaries()}:{state:null,entries:[]}),getTunnelRequest:a.input(u.object({seq:u.number().int().positive()})).query(({ctx:e,input:t})=>e.tunnelMonitor?.entry(t.seq)??null),onTunnelEvent:a.subscription(({ctx:t})=>e(e=>t.tunnelMonitor?t.tunnelMonitor.subscribe(t=>{e.next(t)}):()=>{})),takeScreenshot:a.input(u.object({width:u.number().int().positive(),height:u.number().int().positive(),fileFormat:u.enum(["PNG","JPEG"]),output:u.string()})).mutation(async({input:e,ctx:u})=>{let i;if(0===u.pubsub.screenshotRequest$.observers.length)throw Error("No editor connected. Open the configurator in a browser");let a=crypto.randomUUID(),b=o(u.pubsub.screenshotResult$.pipe(s(e=>e.requestId===a),n(3e4)));u.pubsub.screenshotRequest$.next({requestId:a,width:e.width,height:e.height,fileFormat:e.fileFormat});try{i=await b}catch{throw Error("Screenshot timed out. Ensure configurator is fully loaded")}let c=r(e.output),l=Buffer.from(i.imageBase64,"base64");try{await t(c,l)}catch(e){throw Error(`Failed to save screenshot: ${e instanceof Error?e.message:String(e)}`)}return{filePath:c}}),onScreenshotRequest:a.subscription(({ctx:t})=>e(e=>{let r=t.pubsub.screenshotRequest$.subscribe({next:r=>{t.logger.debug(`Emitting screenshot request to subscriber: ${r.requestId}`),e.next(r)},error:r=>{t.logger.error(`Screenshot request subject error: ${r instanceof Error?r.message:String(r)}`),e.error(r)}});return()=>{t.logger.debug("Screenshot request subscription unsubscribed"),r.unsubscribe()}})),submitScreenshot:a.input(u.object({requestId:u.string(),imageBase64:u.string(),fileFormat:u.enum(["PNG","JPEG"])})).mutation(({input:e,ctx:t})=>{t.logger.debug(`Received screenshot result for request: ${e.requestId}`),t.pubsub.screenshotResult$.next({requestId:e.requestId,imageBase64:e.imageBase64,fileFormat:e.fileFormat})}),reportBrowserConsole:a.input(u.object({level:u.enum(["error","warn","info"]),message:u.string(),source:u.string().optional(),timestamp:u.string().optional()})).mutation(({input:e,ctx:t})=>{if(!t.logBus){let r=e.source?`browser:${e.source}`:"browser";t.logger.warn(`[${r}] ${e.message}`)}t.pubsub.browserConsole$.next({level:e.level,message:e.message,source:e.source,timestamp:e.timestamp})}),onBrowserConsole:a.subscription(({ctx:t})=>e(e=>{let r=t.pubsub.browserConsole$.subscribe({next:t=>{e.next(t)},error:r=>{t.logger.error(`Browser console subject error: ${r instanceof Error?r.message:String(r)}`),e.error(r)}});return()=>{r.unsubscribe()}})),getEditorState:a.input(u.object({sections:u.array(u.enum(["entities","navigation","validation"])).optional()})).mutation(async({input:e,ctx:t})=>{let r;if(0===t.pubsub.stateRequest$.observers.length)throw Error("No editor connected. Open the configurator in a browser");let u=crypto.randomUUID(),i=e.sections??["entities","navigation","validation"],a=o(t.pubsub.stateResult$.pipe(s(e=>e.requestId===u),n(1e4)));t.pubsub.stateRequest$.next({requestId:u,sections:i});try{r=await a}catch{throw Error("State request timed out. Ensure configurator is fully loaded")}return r.state}),onStateRequest:a.subscription(({ctx:t})=>e(e=>{let r=t.pubsub.stateRequest$.subscribe({next:r=>{t.logger.debug(`Emitting state request to subscriber: ${r.requestId}`),e.next(r)},error:r=>{t.logger.error(`State request subject error: ${r instanceof Error?r.message:String(r)}`),e.error(r)}});return()=>{t.logger.debug("State request subscription unsubscribed"),r.unsubscribe()}})),submitEditorState:a.input(u.object({requestId:u.string(),state:u.object({lifecycle:u.object({domainLoaded:u.boolean(),domainContextReady:u.boolean(),configuratorReady:u.boolean(),sessionAuthenticated:u.boolean(),editorMode:u.boolean()}),entities:u.array(u.record(u.unknown())).nullable(),navigation:u.record(u.unknown()).nullable(),validation:u.record(u.unknown()).nullable()})})).mutation(({input:e,ctx:t})=>{t.logger.debug(`Received editor state for request: ${e.requestId}`),t.pubsub.stateResult$.next({requestId:e.requestId,state:e.state})}),getEditorData:a.mutation(async({ctx:e})=>{let t;if(0===e.pubsub.dataRequest$.observers.length)throw Error("No editor connected. Open the configurator in a browser");let r=crypto.randomUUID(),u=o(e.pubsub.dataResult$.pipe(s(e=>e.requestId===r),n(1e4)));e.pubsub.dataRequest$.next({requestId:r});try{t=await u}catch{throw Error("Data request timed out. Ensure configurator is fully loaded")}return t.data}),onDataRequest:a.subscription(({ctx:t})=>e(e=>{let r=t.pubsub.dataRequest$.subscribe({next:r=>{t.logger.debug(`Emitting data request to subscriber: ${r.requestId}`),e.next(r)},error:r=>{t.logger.error(`Data request subject error: ${r instanceof Error?r.message:String(r)}`),e.error(r)}});return()=>{t.logger.debug("Data request subscription unsubscribed"),r.unsubscribe()}})),submitEditorData:a.input(u.object({requestId:u.string(),data:u.object({publishedData:u.record(u.unknown()).nullable(),frontendData:u.record(u.unknown()).nullable(),backendData:u.record(u.unknown()).nullable(),sessionData:u.record(u.unknown()).nullable(),accessData:u.record(u.unknown()).nullable(),webComponentProperties:u.record(u.unknown()).nullable()})})).mutation(({input:e,ctx:t})=>{t.logger.debug(`Received editor data for request: ${e.requestId}`),t.pubsub.dataResult$.next({requestId:e.requestId,data:e.data})}),getEditorScene:a.mutation(async({ctx:e})=>{let t;if(0===e.pubsub.sceneRequest$.observers.length)throw Error("No editor connected. Open the configurator in a browser");let r=crypto.randomUUID(),u=o(e.pubsub.sceneResult$.pipe(s(e=>e.requestId===r),n(1e4)));e.pubsub.sceneRequest$.next({requestId:r});try{t=await u}catch{throw Error("Scene request timed out. Ensure configurator is fully loaded")}return t.scene}),onSceneRequest:a.subscription(({ctx:t})=>e(e=>{let r=t.pubsub.sceneRequest$.subscribe({next:r=>{t.logger.debug(`Emitting scene request to subscriber: ${r.requestId}`),e.next(r)},error:r=>{t.logger.error(`Scene request subject error: ${r instanceof Error?r.message:String(r)}`),e.error(r)}});return()=>{t.logger.debug("Scene request subscription unsubscribed"),r.unsubscribe()}})),submitEditorScene:a.input(u.object({requestId:u.string(),scene:u.record(u.unknown()).nullable()})).mutation(({input:e,ctx:t})=>{t.logger.debug(`Received editor scene for request: ${e.requestId}`),t.pubsub.sceneResult$.next({requestId:e.requestId,scene:e.scene})})});
+import{observable as e}from"@trpc/server/observable";import{writeFile as t}from"fs/promises";import{resolve as r}from"path";import{filter as s,firstValueFrom as n,timeout as o}from"rxjs";import{z as i}from"zod";import{LOG_STREAMS as u}from"../services/log-bus.js";import{publicProcedure as a,router as l}from"./trpc.js";let b=i.enum(["all",...u]),c=e=>{if(!e.variantPreviews)throw Error("Cannot preview variants: this session cannot rewrite project files, because it is not `phoenix dev`. Run `phoenix dev` in the project and try again");return e.variantPreviews};export const commandsRouter=l({getLogs:a.input(i.object({stream:b,beforeSeq:i.number().int().positive().optional(),limit:i.number().int().positive().max(500).default(200)})).query(({input:e,ctx:t})=>{if(!t.logBus)return{entries:[],hasMore:!1,counts:null};let r=t.logBus.query(e);return{entries:r.entries,hasMore:r.hasMore,counts:t.logBus.allCounts()}}),onLog:a.subscription(({ctx:t})=>e(e=>t.logBus?t.logBus.subscribe(t=>{e.next(t)}):()=>{})),getTunnelState:a.query(({ctx:e})=>e.tunnelMonitor?{state:e.tunnelMonitor.state(),entries:e.tunnelMonitor.summaries()}:{state:null,entries:[]}),getTunnelRequest:a.input(i.object({seq:i.number().int().positive()})).query(({ctx:e,input:t})=>e.tunnelMonitor?.entry(t.seq)??null),onTunnelEvent:a.subscription(({ctx:t})=>e(e=>t.tunnelMonitor?t.tunnelMonitor.subscribe(t=>{e.next(t)}):()=>{})),takeScreenshot:a.input(i.object({width:i.number().int().positive(),height:i.number().int().positive(),fileFormat:i.enum(["PNG","JPEG"]),output:i.string()})).mutation(async({input:e,ctx:i})=>{let u;if(0===i.pubsub.screenshotRequest$.observers.length)throw Error("No editor connected. Open the configurator in a browser");let a=crypto.randomUUID(),l=n(i.pubsub.screenshotResult$.pipe(s(e=>e.requestId===a),o(3e4)));i.pubsub.screenshotRequest$.next({requestId:a,width:e.width,height:e.height,fileFormat:e.fileFormat});try{u=await l}catch{throw Error("Screenshot timed out. Ensure configurator is fully loaded")}let b=r(e.output),c=Buffer.from(u.imageBase64,"base64");try{await t(b,c)}catch(e){throw Error(`Failed to save screenshot: ${e instanceof Error?e.message:String(e)}`)}return{filePath:b}}),onScreenshotRequest:a.subscription(({ctx:t})=>e(e=>{let r=t.pubsub.screenshotRequest$.subscribe({next:r=>{t.logger.debug(`Emitting screenshot request to subscriber: ${r.requestId}`),e.next(r)},error:r=>{t.logger.error(`Screenshot request subject error: ${r instanceof Error?r.message:String(r)}`),e.error(r)}});return()=>{t.logger.debug("Screenshot request subscription unsubscribed"),r.unsubscribe()}})),submitScreenshot:a.input(i.object({requestId:i.string(),imageBase64:i.string(),fileFormat:i.enum(["PNG","JPEG"])})).mutation(({input:e,ctx:t})=>{t.logger.debug(`Received screenshot result for request: ${e.requestId}`),t.pubsub.screenshotResult$.next({requestId:e.requestId,imageBase64:e.imageBase64,fileFormat:e.fileFormat})}),reportBrowserConsole:a.input(i.object({level:i.enum(["error","warn","info"]),message:i.string(),source:i.string().optional(),timestamp:i.string().optional()})).mutation(({input:e,ctx:t})=>{if(!t.logBus){let r=e.source?`browser:${e.source}`:"browser";t.logger.warn(`[${r}] ${e.message}`)}t.pubsub.browserConsole$.next({level:e.level,message:e.message,source:e.source,timestamp:e.timestamp})}),onBrowserConsole:a.subscription(({ctx:t})=>e(e=>{let r=t.pubsub.browserConsole$.subscribe({next:t=>{e.next(t)},error:r=>{t.logger.error(`Browser console subject error: ${r instanceof Error?r.message:String(r)}`),e.error(r)}});return()=>{r.unsubscribe()}})),getEditorState:a.input(i.object({sections:i.array(i.enum(["entities","navigation","validation"])).optional()})).mutation(async({input:e,ctx:t})=>{let r;if(0===t.pubsub.stateRequest$.observers.length)throw Error("No editor connected. Open the configurator in a browser");let i=crypto.randomUUID(),u=e.sections??["entities","navigation","validation"],a=n(t.pubsub.stateResult$.pipe(s(e=>e.requestId===i),o(1e4)));t.pubsub.stateRequest$.next({requestId:i,sections:u});try{r=await a}catch{throw Error("State request timed out. Ensure configurator is fully loaded")}return r.state}),onStateRequest:a.subscription(({ctx:t})=>e(e=>{let r=t.pubsub.stateRequest$.subscribe({next:r=>{t.logger.debug(`Emitting state request to subscriber: ${r.requestId}`),e.next(r)},error:r=>{t.logger.error(`State request subject error: ${r instanceof Error?r.message:String(r)}`),e.error(r)}});return()=>{t.logger.debug("State request subscription unsubscribed"),r.unsubscribe()}})),submitEditorState:a.input(i.object({requestId:i.string(),state:i.object({lifecycle:i.object({domainLoaded:i.boolean(),domainContextReady:i.boolean(),configuratorReady:i.boolean(),sessionAuthenticated:i.boolean(),editorMode:i.boolean()}),entities:i.array(i.record(i.unknown())).nullable(),navigation:i.record(i.unknown()).nullable(),validation:i.record(i.unknown()).nullable()})})).mutation(({input:e,ctx:t})=>{t.logger.debug(`Received editor state for request: ${e.requestId}`),t.pubsub.stateResult$.next({requestId:e.requestId,state:e.state})}),getEditorData:a.mutation(async({ctx:e})=>{let t;if(0===e.pubsub.dataRequest$.observers.length)throw Error("No editor connected. Open the configurator in a browser");let r=crypto.randomUUID(),i=n(e.pubsub.dataResult$.pipe(s(e=>e.requestId===r),o(1e4)));e.pubsub.dataRequest$.next({requestId:r});try{t=await i}catch{throw Error("Data request timed out. Ensure configurator is fully loaded")}return t.data}),onDataRequest:a.subscription(({ctx:t})=>e(e=>{let r=t.pubsub.dataRequest$.subscribe({next:r=>{t.logger.debug(`Emitting data request to subscriber: ${r.requestId}`),e.next(r)},error:r=>{t.logger.error(`Data request subject error: ${r instanceof Error?r.message:String(r)}`),e.error(r)}});return()=>{t.logger.debug("Data request subscription unsubscribed"),r.unsubscribe()}})),submitEditorData:a.input(i.object({requestId:i.string(),data:i.object({publishedData:i.record(i.unknown()).nullable(),frontendData:i.record(i.unknown()).nullable(),backendData:i.record(i.unknown()).nullable(),sessionData:i.record(i.unknown()).nullable(),accessData:i.record(i.unknown()).nullable(),webComponentProperties:i.record(i.unknown()).nullable()})})).mutation(({input:e,ctx:t})=>{t.logger.debug(`Received editor data for request: ${e.requestId}`),t.pubsub.dataResult$.next({requestId:e.requestId,data:e.data})}),getEditorScene:a.mutation(async({ctx:e})=>{let t;if(0===e.pubsub.sceneRequest$.observers.length)throw Error("No editor connected. Open the configurator in a browser");let r=crypto.randomUUID(),i=n(e.pubsub.sceneResult$.pipe(s(e=>e.requestId===r),o(1e4)));e.pubsub.sceneRequest$.next({requestId:r});try{t=await i}catch{throw Error("Scene request timed out. Ensure configurator is fully loaded")}return t.scene}),onSceneRequest:a.subscription(({ctx:t})=>e(e=>{let r=t.pubsub.sceneRequest$.subscribe({next:r=>{t.logger.debug(`Emitting scene request to subscriber: ${r.requestId}`),e.next(r)},error:r=>{t.logger.error(`Scene request subject error: ${r instanceof Error?r.message:String(r)}`),e.error(r)}});return()=>{t.logger.debug("Scene request subscription unsubscribed"),r.unsubscribe()}})),submitEditorScene:a.input(i.object({requestId:i.string(),scene:i.record(i.unknown()).nullable()})).mutation(({input:e,ctx:t})=>{t.logger.debug(`Received editor scene for request: ${e.requestId}`),t.pubsub.sceneResult$.next({requestId:e.requestId,scene:e.scene})}),previewVariants:a.input(i.object({title:i.string(),description:i.string(),variants:i.array(i.object({id:i.string(),kind:i.enum(["script","page"]),label:i.string(),description:i.string(),url:i.string().refine(e=>{try{let t=decodeURIComponent(new URL(e,"http://variant.invalid").pathname);return e.startsWith("/variants/")&&t.startsWith("/variants/")&&!t.includes("\\")&&!t.split("/").some(e=>"."===e||".."===e)}catch{return!1}},"Option URLs must stay below /variants/; use a file from the variant set")})).min(1),timeoutMs:i.number().int().positive().max(0x7fffffff)})).mutation(({input:e,ctx:t})=>c(t).open(e)),onVariantPreview:a.subscription(({ctx:t})=>e(e=>{let r=t.variantPreviews;if(!r)return e.next(null),()=>void 0;let s=r.request$.subscribe(t=>{e.next(t)});return()=>{s.unsubscribe()}})),getVariantBaseline:a.input(i.object({requestId:i.string()})).query(({input:e,ctx:t})=>c(t).getBaseline(e.requestId)),applyVariantFiles:a.input(i.object({requestId:i.string(),choice:i.string().nullable(),files:i.array(i.object({fileName:i.string(),content:i.string().nullable()}))})).mutation(({input:e,ctx:t})=>c(t).applyFiles(e)),submitVariantChoice:a.input(i.object({requestId:i.string(),choice:i.string().nullable()})).mutation(({input:e,ctx:t})=>c(t).submit(e)),closeVariantPreview:a.mutation(({ctx:e})=>e.variantPreviews?.close()??Promise.resolve({closed:!1})),claimVariantChoice:a.input(i.object({requestId:i.string()})).mutation(({input:e,ctx:t})=>{t.variantPreviews?.claim(e.requestId)})});

package/dist/phoenix/editor-server/editor-router.d.ts

@@ -165,6 +165,71 @@ export declare const appRouter: import("@trpc/server").TRPCBuiltRouter<{
         output: void;
         meta: object;
     }>;
+    previewVariants: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            title: string;
+            description: string;
+            variants: {
+                id: string;
+                kind: "page" | "script";
+                label: string;
+                description: string;
+                url: string;
+            }[];
+            timeoutMs: number;
+        };
+        output: import("../services/variant-preview-service.js").VariantPreviewOutcome;
+        meta: object;
+    }>;
+    onVariantPreview: import("@trpc/server/unstable-core-do-not-import").LegacyObservableSubscriptionProcedure<{
+        input: void;
+        output: import("./protocol.js").VariantPreviewRequest | null;
+        meta: object;
+    }>;
+    getVariantBaseline: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            requestId: string;
+        };
+        output: {
+            readonly files: readonly import("../services/variant-file-session.js").VariantFileEdit[];
+            readonly choice: string | null;
+        };
+        meta: object;
+    }>;
+    applyVariantFiles: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            requestId: string;
+            choice: string | null;
+            files: {
+                fileName: string;
+                content: string | null;
+            }[];
+        };
+        output: void;
+        meta: object;
+    }>;
+    submitVariantChoice: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            requestId: string;
+            choice: string | null;
+        };
+        output: void;
+        meta: object;
+    }>;
+    closeVariantPreview: import("@trpc/server").TRPCMutationProcedure<{
+        input: void;
+        output: {
+            readonly closed: boolean;
+        };
+        meta: object;
+    }>;
+    claimVariantChoice: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            requestId: string;
+        };
+        output: void;
+        meta: object;
+    }>;
 }> & import("@trpc/server").TRPCDecorateCreateRouterOptions<{
     saveMock: import("@trpc/server").TRPCMutationProcedure<{
         input: {

package/dist/phoenix/editor-server/editor-server.d.ts

@@ -1,11 +1,11 @@
 import type { LogBus } from '../services/log-bus.js';
-import type { PhoenixPubSub } from '../services/phoenix-pubsub.js';
+import type { PhoenixApplication } from '../services/phoenix-application.js';
 import type { WebhookTunnelMonitor } from '../services/webhook-tunnel-monitor.js';
 import type { Logger } from '../utils/index.js';
 export interface EditorServerOptions {
     readonly port: number;
     readonly projectRoot: string;
-    readonly pubsub: PhoenixPubSub;
+    readonly application: PhoenixApplication;
     readonly logger: Logger;
     readonly debug?: boolean;
     /** Bound to this dev session; absent for offline and story sessions. */
@@ -14,7 +14,7 @@ export interface EditorServerOptions {
     readonly logBus?: LogBus;
     readonly tunnelMonitor?: WebhookTunnelMonitor;
 }
-export declare const startEditorServer: ({ port, projectRoot, pubsub, logger, prepareDeployment, storyMode, logBus, tunnelMonitor, }: EditorServerOptions) => {
+export declare const startEditorServer: ({ port, projectRoot, application, logger, prepareDeployment, storyMode, logBus, tunnelMonitor, }: EditorServerOptions) => {
     ready: Promise<void>;
     close: () => Promise<void>;
 };

package/dist/phoenix/editor-server/editor-server.js

@@ -1 +1 @@
-import{applyWSSHandler as e}from"@trpc/server/adapters/ws";import{WebSocketServer as o}from"ws";import{appRouter as r}from"./editor-router.js";export const startEditorServer=({port:n,projectRoot:t,pubsub:i,logger:s,prepareDeployment:c,storyMode:l,logBus:a,tunnelMonitor:f})=>{let m=new o({port:n}),d=e({wss:m,router:r,createContext:()=>({projectRoot:t,pubsub:i,logger:s,prepareDeployment:c,storyMode:l,logBus:a,tunnelMonitor:f})});m.on("connection",(e,o)=>{let r=o.headers.origin??"unknown";s.info(`WS connected (clients: ${m.clients.size}, origin: ${r})`),e.on("error",e=>{s.warn(`WS error: ${e.message}`)}),e.once("close",(e,o)=>{s.info(`WS disconnected (clients: ${m.clients.size}, code: ${e}, reason: ${o.toString()||"none"})`)})}),m.on("error",e=>{s.error(`WebSocket server error: ${e.message}`)});let S=new Promise((e,o)=>{let r=()=>{m.off("error",t),s.info(`WebSocket Server listening on ws://localhost:${n}`),e()},t=e=>{m.off("listening",r),o(e)};m.once("listening",r),m.once("error",t)}),g=null;return{ready:S,close:()=>g||(s.info("Shutting down WebSocket server"),d.broadcastReconnectNotification(),g=new Promise((e,o)=>{let r=setTimeout(()=>{for(let e of m.clients)e.terminate()},3e3);m.close(n=>{clearTimeout(r),n?o(n):e()})}))}};
+import{applyWSSHandler as e}from"@trpc/server/adapters/ws";import{WebSocketServer as r}from"ws";import{appRouter as o}from"./editor-router.js";export const startEditorServer=({port:n,projectRoot:t,application:i,logger:s,prepareDeployment:c,storyMode:l,logBus:a,tunnelMonitor:f})=>{let m=new r({port:n}),u=e({wss:m,router:o,createContext:()=>({projectRoot:t,pubsub:i.pubsub,variantPreviews:i.variantPreviews,logger:s,prepareDeployment:c,storyMode:l,logBus:a,tunnelMonitor:f})});m.on("connection",(e,r)=>{let o=r.headers.origin??"unknown";s.info(`WS connected (clients: ${m.clients.size}, origin: ${o})`),e.on("error",e=>{s.warn(`WS error: ${e.message}`)}),e.once("close",(e,r)=>{s.info(`WS disconnected (clients: ${m.clients.size}, code: ${e}, reason: ${r.toString()||"none"})`)})}),m.on("error",e=>{s.error(`WebSocket server error: ${e.message}`)});let w=new Promise((e,r)=>{let o=()=>{m.off("error",t),s.info(`WebSocket Server listening on ws://localhost:${n}`),e()},t=e=>{m.off("listening",o),r(e)};m.once("listening",o),m.once("error",t)}),d=null;return{ready:w,close:()=>d||(s.info("Shutting down WebSocket server"),u.broadcastReconnectNotification(),d=new Promise((e,r)=>{let o=setTimeout(()=>{for(let e of m.clients)e.terminate()},3e3);m.close(n=>{clearTimeout(o),n?r(n):e()})}))}};

package/dist/phoenix/editor-server/protocol.d.ts

@@ -1,3 +1,4 @@
 /** Internal browser/editor protocol. This entry has no runtime package mapping. */
 export type { AppRouter } from './editor-router.js';
 export type { DataRequest, EditorContextData, SceneRequest, EditorLifecycleStatus, StateRequest, ScreenshotRequest, } from '../services/phoenix-pubsub.js';
+export type { VariantPreviewOption, VariantPreviewRequest } from '../services/phoenix-store.js';

package/dist/phoenix/editor-server/spec-router.js

@@ -1 +1 @@
-import{TRPCError as e}from"@trpc/server";import{observable as o}from"@trpc/server/observable";import{writeFile as t}from"fs/promises";import{join as r}from"path";import{z as i}from"zod";import{readApplicationFiles as p}from"../application-spec/index.js";import{exists as s}from"../utils/index.js";import{publicProcedure as n,router as a}from"./trpc.js";export const specRouter=a({getEditorConfig:n.query(()=>({specSync:!0})),prepareDeployment:n.mutation(async({ctx:o})=>{if(o.storyMode)throw new e({code:"BAD_REQUEST",message:"Deployment preparation is disabled in Storybook story mode."});if(!o.prepareDeployment)throw new e({code:"BAD_REQUEST",message:"Deployment preparation requires a deployment configuration outside story mode."});await o.prepareDeployment()}),requestSpecFiles:n.mutation(async({ctx:e})=>{let o=e.storyMode?await p({projectRoot:e.projectRoot,envs:{}}):await p();e.pubsub.specFile$.next({rawProjectFiles:o,projectRoot:e.projectRoot})}),save:n.input(i.array(i.object({fileName:i.string(),content:i.string()}))).mutation(async({ctx:e,input:o})=>{for(let i of o){let o=r(e.projectRoot,i.fileName),p=r(e.projectRoot,i.fileName.split("/").slice(0,-1).join("/"));await s(p)&&await t(o,i.content)}}),onSpecChange:n.subscription(({ctx:e})=>o(o=>{let t=e.pubsub.specFile$.subscribe(e=>{o.next(e)});return()=>{t.unsubscribe()}}))});
+import{TRPCError as e}from"@trpc/server";import{observable as o}from"@trpc/server/observable";import{writeFile as t}from"fs/promises";import{join as r}from"path";import{z as i}from"zod";import{readApplicationFiles as s}from"../application-spec/index.js";import{exists as p}from"../utils/index.js";import{publicProcedure as a,router as n}from"./trpc.js";export const specRouter=n({getEditorConfig:a.query(()=>({specSync:!0})),prepareDeployment:a.mutation(async({ctx:o})=>{if(o.variantPreviews?.isOpen)throw new e({code:"BAD_REQUEST",message:"Deployment preparation is disabled during variant previews. Close the preview first."});if(o.storyMode)throw new e({code:"BAD_REQUEST",message:"Deployment preparation is disabled in Storybook story mode."});if(!o.prepareDeployment)throw new e({code:"BAD_REQUEST",message:"Deployment preparation requires a deployment configuration outside story mode."});await o.prepareDeployment()}),requestSpecFiles:a.mutation(async({ctx:e})=>{let o=e.storyMode?await s({projectRoot:e.projectRoot,envs:{}}):await s();e.pubsub.specFile$.next({rawProjectFiles:o,projectRoot:e.projectRoot})}),save:a.input(i.array(i.object({fileName:i.string(),content:i.string()}))).mutation(async({ctx:o,input:i})=>{if(o.variantPreviews?.isOpen)throw new e({code:"BAD_REQUEST",message:"Close the variant preview before editing source files."});for(let e of i){let i=r(o.projectRoot,e.fileName),s=r(o.projectRoot,e.fileName.split("/").slice(0,-1).join("/"));await p(s)&&await t(i,e.content)}}),onSpecChange:a.subscription(({ctx:e})=>o(o=>{let t=e.pubsub.specFile$.subscribe(e=>{o.next(e)});return()=>{t.unsubscribe()}}))});

package/dist/phoenix/editor-server/trpc.d.ts

@@ -1,11 +1,14 @@
 import type { LogBus } from '../services/log-bus.js';
 import type { PhoenixPubSub } from '../services/phoenix-pubsub.js';
+import type { VariantPreviewService } from '../services/variant-preview-service.js';
 import type { WebhookTunnelMonitor } from '../services/webhook-tunnel-monitor.js';
 import type { Logger } from '../utils/index.js';
 export type Context = {
     readonly projectRoot: string;
     readonly pubsub: PhoenixPubSub;
     readonly logger: Logger;
+    /** The session's variant comparison; absent where project files cannot be rewritten, such as story-dev. */
+    readonly variantPreviews: VariantPreviewService | undefined;
     /** Bound to this dev session; absent for offline and story sessions. */
     readonly prepareDeployment?: () => Promise<void>;
     readonly storyMode?: boolean;

package/dist/phoenix/scripts/build-admin.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node --stack-size=8192
-import{mkdir as e,readFile as o,rm as a,writeFile as r}from"node:fs/promises";import{dirname as t,join as i}from"node:path";import{format as s}from"prettier";import{prettierrc as n}from"@salsita-ai/common/prettier";import{buildPhoenixDefinitions as m,generateStandaloneCommonAdminFiles as c,parseCommonAdminSpec as p}from"#package/application-spec";import{getAllPhxDefinitions as l}from"#package/domain";import{swcEvalExpressionParser as d}from"../application-spec/swc-module-analyzer.js";let f=async e=>{try{return await o(e,"utf-8")}catch{return}},w=async(e,o)=>{let a=await s(o,{...n,filepath:e});await f(e)!==a&&await r(e,a)},v="./src/domain/admin-domain/__generated",h=m(l()),u=p(h,{evalExpressionParser:d});if(!u.ok)throw console.error(u.errors),Error("Common admin application spec contains errors");let j=c({enhancedModelImportPaths:{domainModel:"../../core/model.js",model:"./model/index.js",violation:"../../invariants/violation.js"},phxDefinitions:h,spec:u.value,versionImportPaths:{model:"../../../../core/model.js",reflection:"../../../../core/reflection.js"}});await e(v,{recursive:!0}),await Promise.all(j.map(async o=>{let a=i(v,o.path);await e(t(a),{recursive:!0}),await w(a,o.content)})),await a(i(v,"presets.ts"),{force:!0});
+import{mkdir as e,readFile as r,rm as a,writeFile as o}from"node:fs/promises";import{dirname as i,join as t}from"node:path";import{format as n}from"prettier";import{prettierrc as s}from"@salsita-ai/common/prettier";import{buildPhoenixDefinitions as m,generateStandaloneCommonAdminFiles as c,parseCommonAdminSpec as p}from"#package/application-spec";import{getAllPhxDefinitions as l}from"#package/domain";import{swcEvalExpressionParser as d}from"../application-spec/swc-module-analyzer.js";let f=async e=>{try{return await r(e,"utf-8")}catch{return}},w=async(e,r)=>{let a=await n(r,{...s,filepath:e});await f(e)!==a&&await o(e,a)},h="./src/domain/admin-domain/__generated",u=m(l()),v=p(u,{evalExpressionParser:d});if(!v.ok)throw console.error(v.errors),Error("Common admin application spec contains errors");let j=c({enhancedModelImportPaths:{domainModel:"../../core/index.js",model:"./model/index.js",violation:"../../core/index.js"},phxDefinitions:u,spec:v.value,versionImportPaths:{model:"../../../../core/index.js",reflection:"../../../../core/index.js"}});await e(h,{recursive:!0}),await Promise.all(j.map(async r=>{let a=t(h,r.path);await e(i(a),{recursive:!0}),await w(a,r.content)})),await a(t(h,"presets.ts"),{force:!0});

package/dist/phoenix/services/application-spec-project-watcher.d.ts

@@ -1,9 +1,11 @@
 import { type ViteDevServer } from 'vite';
 import type { Logger } from '../utils/index.js';
 import type { PhoenixPubSub } from './phoenix-pubsub.js';
+import type { VariantFileEdit } from './variant-file-session.js';
+export declare const WATCH_PATTERNS: string[];
+export declare const IGNORED_PATTERNS: string[];
 /** Configuration for {@link ApplicationSpecProjectWatcher}. */
 export interface ApplicationSpecProjectWatcherConfig {
-    readonly viteServer: ViteDevServer;
     readonly pubsub: PhoenixPubSub;
     readonly logger: Logger;
     readonly onRebuilt?: () => void;
@@ -42,8 +44,19 @@ export declare class ApplicationSpecProjectWatcher {
     private readonly builder;
     private readonly useServer;
     private isShuttingDown;
+    private suspended;
+    private readonly heldChanges;
     constructor(config: ApplicationSpecProjectWatcherConfig);
-    start(): void;
+    start(viteServer: ViteDevServer): void;
+    /** Rebuilds a batch a variant comparison wrote, at once and without the server work of a source change. */
+    applyVariantFiles(files: readonly VariantFileEdit[]): void;
+    /**
+     * Holds source changes back until `resume`: a variant comparison rewrites files and rebuilds them itself,
+     * and a rebuild from the watcher would repeat that with the server work on top.
+     */
+    suspend(): void;
+    /** Rebuilds once for everything that changed while suspended, so no edit made meanwhile is lost. */
+    resume(): void;
     close(): Promise<void>;
     private setupFileWatcher;
     private setupRebuildSubscription;

package/dist/phoenix/services/application-spec-project-watcher.js

@@ -1,4 +1,4 @@
-import{resolve as e}from"path";import t from"promise-queue";import{Subject as i,buffer as s,debounceTime as r}from"rxjs";import{createServer as o,normalizePath as n}from"vite";import{watch as l}from"#package/watch";import{ApplicationSpecBuilder as c}from"../application-spec/application-spec-builder.js";import{logDiagnostics as a}from"../application-spec/metrics/index.js";import{syncTemplateFiles as h}from"../application-spec/template-files.js";import{buildWebhooks as u}from"../webhooks/index.js";import{getViteDevConfig as p}from"./vite-config.js";let g=["spec/**/*.{yaml,yml}","src/**/*.{ts,tsx,yaml,yml,json,html,css}","templates/*.html",".env",".env.generated"],b=["src/locales/**/*.{ts,tsx}",".phoenix/**"];export class ApplicationSpecProjectWatcher{watcher=null;subscription=null;rebuildQueue=new t(1,1/0);changeSubject$=new i;viteServer;pubsub;logger;onRebuilt;onViteServerChange;builder;useServer;isShuttingDown=!1;constructor(e){this.viteServer=e.viteServer,this.pubsub=e.pubsub,this.logger=e.logger,this.onRebuilt=e.onRebuilt,this.onViteServerChange=e.onViteServerChange,this.builder=new c({logger:e.logger,sdkVersion:e.sdkVersion,projectSlug:e.projectSlug,environmentSlug:e.environmentSlug,cliUseWorkspace:e.cliUseWorkspace,name:e.name,description:e.description,enableEditor:e.enableEditor,inlineTemplates:e.inlineTemplates}),this.useServer=e.useServer}start(){this.setupFileWatcher(),this.setupRebuildSubscription()}async close(){this.isShuttingDown=!0,this.watcher&&(await this.watcher.close(),this.watcher=null),this.subscription?.unsubscribe(),this.changeSubject$.complete()}setupFileWatcher(){this.watcher=l(g,{ignored:b,cwd:process.cwd(),persistent:!0,ignoreInitial:!1}),this.watcher.on("all",(e,t)=>{("change"===e||"add"===e||"unlink"===e)&&(this.logger.info(`
-📝 Detected ${e}: ${t}`),this.changeSubject$.next(t))})}setupRebuildSubscription(){let e=this.changeSubject$.pipe(r(10));this.subscription=this.changeSubject$.pipe(s(e)).subscribe(e=>{let t=new Set(e),i=t.has(".env");this.rebuildQueue.add(async()=>{this.isShuttingDown||(this.logger.info(`
+import{mkdirSync as e}from"fs";import{resolve as t}from"path";import i from"promise-queue";import{Subject as s,buffer as r,debounceTime as o}from"rxjs";import{createServer as n,normalizePath as l}from"vite";import{watch as a}from"#package/watch";import{ApplicationSpecBuilder as h}from"../application-spec/application-spec-builder.js";import{logDiagnostics as c}from"../application-spec/metrics/index.js";import{syncTemplateFiles as u}from"../application-spec/template-files.js";import{buildWebhooks as p}from"../webhooks/index.js";import{getViteDevConfig as g}from"./vite-config.js";export const WATCH_PATTERNS=["spec/**/*.{yaml,yml}","src/**/*.{ts,tsx,yaml,yml,json,html,css}","templates/*.html",".env",".env.generated",".phoenix/.env.generated"];export const IGNORED_PATTERNS=["src/locales/**/*.{ts,tsx}",".phoenix/!(.env.generated)/**"];export class ApplicationSpecProjectWatcher{watcher=null;subscription=null;rebuildQueue=new i(1,1/0);changeSubject$=new s;viteServer=null;pubsub;logger;onRebuilt;onViteServerChange;builder;useServer;isShuttingDown=!1;suspended=!1;heldChanges=new Set;constructor(e){this.pubsub=e.pubsub,this.logger=e.logger,this.onRebuilt=e.onRebuilt,this.onViteServerChange=e.onViteServerChange,this.builder=new h({logger:e.logger,sdkVersion:e.sdkVersion,projectSlug:e.projectSlug,environmentSlug:e.environmentSlug,cliUseWorkspace:e.cliUseWorkspace,name:e.name,description:e.description,enableEditor:e.enableEditor,inlineTemplates:e.inlineTemplates}),this.useServer=e.useServer}start(e){this.viteServer=e,this.setupFileWatcher(),this.setupRebuildSubscription()}applyVariantFiles(e){this.rebuildQueue.add(async()=>{this.isShuttingDown||await this.rebuild(new Set(e.map(e=>e.fileName)),!1,!0)})}suspend(){this.suspended=!0}resume(){for(let e of(this.suspended=!1,this.heldChanges))this.changeSubject$.next(e);this.heldChanges.clear()}async close(){this.isShuttingDown=!0,this.watcher&&(await this.watcher.close(),this.watcher=null),this.subscription?.unsubscribe(),this.changeSubject$.complete()}setupFileWatcher(){e(t(process.cwd(),"src"),{recursive:!0}),this.watcher=a(WATCH_PATTERNS,{ignored:IGNORED_PATTERNS,cwd:process.cwd(),persistent:!0,ignoreInitial:!1}),this.watcher.on("all",(e,t)=>{if("change"===e||"add"===e||"unlink"===e){if(this.suspended)return void this.heldChanges.add(t);this.logger.info(`
+📝 Detected ${e}: ${t}`),this.changeSubject$.next(t)}})}setupRebuildSubscription(){let e=this.changeSubject$.pipe(o(10));this.subscription=this.changeSubject$.pipe(r(e)).subscribe(e=>{let t=new Set(e),i=t.has(".env");this.rebuildQueue.add(async()=>{this.isShuttingDown||(this.logger.info(`
 🔨 Rebuilding spec files...
-`),await this.rebuild(t,i))})})}async rebuild(t,i){try{let s=await h();if(this.isShuttingDown)return;let r=await this.builder.build();if(this.isShuttingDown)return;if(a(r.diagnostics,this.logger),!r.ok){for(let e of r.errors)this.logger.error(`[${e.code}] ${e.message}${e.file?` (${e.file})`:""}`);this.pubsub.specFile$.next({rawProjectFiles:r.rawProjectFiles,projectRoot:process.cwd()});return}this.onRebuilt?.();let{application:l,changedFiles:c}=r,g=this.viteServer.moduleGraph,b=Date.now(),w=new Set,d=process.cwd(),f=e=>{let t=g.getModulesByFile(n(e));if(t)for(let e of t)g.invalidateModule(e,w,b,!0)};for(let i of t)f(e(d,i));for(let t of c)f(e(d,`.phoenix/${t.path}`));if(this.pubsub.specFile$.next({rawProjectFiles:l.rawProjectFiles,projectRoot:process.cwd(),configurationSchemaHash:l.applicationSpec.configurator.configurationSchema.hash}),this.isShuttingDown)return;if(i){if(await this.viteServer.close(),this.isShuttingDown)return;let e=await p({templateFiles:s});if(this.isShuttingDown)return;let t=await o(e);if(this.isShuttingDown||(await t.listen(),this.isShuttingDown))return void await t.close();this.viteServer=t,this.onViteServerChange?.(t),this.logger.success("Vite server restarted (env changed)")}if(this.useServer){if(this.logger.step("Building webhooks"),await u({experimental:!0,skipNodeEnvOverride:!0,webhookEntryPoint:"./.phoenix/.swc/.phoenix/webhook.js",preserveExistingOutput:!0}),this.isShuttingDown)return;this.logger.success("Webhooks rebuilt successfully")}this.logger.success("Project files rebuilt successfully")}catch(e){this.logger.error(`Build failed: ${e instanceof Error?e.message:String(e)}`,e)}}}
+`),await this.rebuild(t,i,!1))})})}async rebuild(e,i,s){try{let r=this.viteServer;if(!r)throw Error("Cannot rebuild the project: the watcher has no Vite server yet, because it was not started. Start the watcher before applying files");let o=await u();if(this.isShuttingDown)return;let a=await this.builder.build({compile:!s});if(this.isShuttingDown)return;if(c(a.diagnostics,this.logger),!a.ok){for(let e of a.errors)this.logger.error(`[${e.code}] ${e.message}${e.file?` (${e.file})`:""}`);this.pubsub.specFile$.next({rawProjectFiles:a.rawProjectFiles,projectRoot:process.cwd()});return}this.onRebuilt?.();let{application:h,changedFiles:d}=a,w=r.moduleGraph,b=Date.now(),f=new Set,S=process.cwd(),m=e=>{let t=w.getModulesByFile(l(e));if(t)for(let e of t)w.invalidateModule(e,f,b,!0)};for(let i of e)m(t(S,i));for(let e of d)m(t(S,`.phoenix/${e.path}`));if(this.pubsub.specFile$.next({rawProjectFiles:h.rawProjectFiles,projectRoot:process.cwd(),configurationSchemaHash:h.applicationSpec.configurator.configurationSchema.hash}),this.isShuttingDown)return;if(i){if(await r.close(),this.isShuttingDown)return;let e=await g({templateFiles:o});if(this.isShuttingDown)return;let t=await n(e);if(this.isShuttingDown||(await t.listen(),this.isShuttingDown))return void await t.close();this.viteServer=t,this.onViteServerChange?.(t),this.logger.success("Vite server restarted (env changed)")}if(this.useServer&&!s){if(this.logger.step("Building webhooks"),await p({experimental:!0,skipNodeEnvOverride:!0,webhookEntryPoint:"./.phoenix/.swc/.phoenix/webhook.js",preserveExistingOutput:!0}),this.isShuttingDown)return;this.logger.success("Webhooks rebuilt successfully")}this.logger.success("Project files rebuilt successfully")}catch(e){this.logger.error(`Build failed: ${e instanceof Error?e.message:String(e)}`,e)}}}