@salsita-ai/sdk 0.50.0-develop.bc08a38ffe → 0.50.0-develop.bc204720a8

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,...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!")};
+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 g=r(h);n.debug(`Using server URL: ${h}`);let y=await t({skipUpload:d,logger:n});n.info("Preparing a local environment and deployment on the server...");let{data:b,error:w}=await g.POST("/environments/prepare",{body:{projectSlug:p,environmentSlug:v,applicationVersion:y.applicationVersion,publishedDataHash:y.publishedDataHash,useAuthHook:y.useAuthHook,useCognito:y.useCognito,overrideSchema:m,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":u,"x-project-key":l,"x-project-slug":p}});if(w)throw Error(`Failed to prepare deployment with server: ${w.message}`);if(!b)throw Error("No data returned from server");n.debug("Deployment prepared on server");let E=b.environmentVariables,F=b.privateUploadUrls,P=b.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:[...y.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:[...y.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 g.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 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)};
+import{readFile as t,writeFile as o}from"fs/promises";import{globby as e}from"globby";import{resolve as r}from"path";import*as i from"prettier";import{prettierrc as a}from"@salsita-ai/common/prettier";let n=["**/node_modules/**","**/dist/**","**/.git/**","**/.phoenix/**","**/locales/*/*.ts","pnpm-lock.yaml","pnpm-workspace.yaml","package-lock.json","npm-shrinkwrap.json","yarn.lock",".yarnrc.yml","bun.lock","bun.lockb",".linguirc"];export const formatFiles=async(l,f)=>{let{logger:c}=f,s=await e("."===l?"**/*":l,{gitignore:!0,ignore:n}),m=0;for(let e of s)try{let n=r(e),l=await t(n,"utf-8"),f=await i.resolveConfig(n)??a;if((await i.getFileInfo(n)).ignored)continue;let c=await i.format(l,{...f,filepath:n});c!==l&&(await o(n,c,"utf-8"),m++)}catch(t){}m>0&&c.info(`Formatted ${m} file${1!==m?"s":""}`)};export const checkFiles=async(o,l)=>{let{logger:f}=l,c=await e("."===o?"**/*":o,{gitignore:!0,ignore:n}),s=[];for(let o of c)try{let e=r(o),n=await t(e,"utf-8"),l=await i.resolveConfig(e)??a;if((await i.getFileInfo(e)).ignored)continue;await i.check(n,{...l,filepath:e})||s.push(o)}catch(t){}return!(s.length>0)||(f.error(`Found ${s.length} unformatted file${1!==s.length?"s":""}:`),s.forEach(t=>{console.error(`  - ${t}`)}),!1)};

package/dist/phoenix/commands/register-deployment.js

@@ -1 +1 @@
-import{runCommand as e}from"../utils/index.js";export const runRegisterDeploymentCommand=async(t,i)=>{let{logger:r}=i;try{r.warn("DEPRECATED: deployment:register command is deprecated, switch to a new workflow and use deployment:prepare and deployment:finish instead"),r.step("Registering deployment");let i=["register"];t?.server&&i.push("--server",`"${t.server}"`),t?.apiKey&&i.push("--apiKey",`"${t.apiKey}"`),t?.outFile&&i.push("--outFile",`"${t.outFile}"`),t?.skipUpload&&i.push("--skipUpload"),t?.activate===void 0||t.activate||i.push("--activate","false"),t?.overrideSchema&&i.push("--overrideSchema"),i.push("--configPath",'"./.phoenix/phoenix.config.ts"'),await e({command:"deployment-cli",args:i,description:"Registering deployment"},{logger:r}),r.success("Deployment registered successfully!")}catch(e){r.error(`Deployment registration failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};
+import{exitCli as e}from"../services/index.js";import{runCommand as i}from"../utils/index.js";export const runRegisterDeploymentCommand=async(t,r)=>{let{logger:s}=r;try{s.warn("DEPRECATED: deployment:register command is deprecated, switch to a new workflow and use deployment:prepare and deployment:finish instead"),s.step("Registering deployment");let e=["register"];t?.server&&e.push("--server",`"${t.server}"`),t?.apiKey&&e.push("--apiKey",`"${t.apiKey}"`),t?.outFile&&e.push("--outFile",`"${t.outFile}"`),t?.skipUpload&&e.push("--skipUpload"),t?.activate===void 0||t.activate||e.push("--activate","false"),t?.overrideSchema&&e.push("--overrideSchema"),e.push("--configPath",'"./.phoenix/phoenix.config.ts"'),await i({command:"deployment-cli",args:e,description:"Registering deployment"},{logger:s}),s.success("Deployment registered successfully!")}catch(i){s.error(`Deployment registration failed: ${i instanceof Error?i.message:String(i)}`,i),await e(1)}};

package/dist/phoenix/commands/scene.js

@@ -1 +1 @@
-import{createTRPCClient as e,createWSClient as t,wsLink as r}from"@trpc/client";import{writeFile as o}from"fs/promises";import{resolve as i}from"path";import s from"ws";export const runSceneCommand=async(n,c)=>{let{logger:l}=c,a=n.port??"3020",p=n.pretty??!0,m=t({url:`ws://localhost:${a}`,WebSocket:s}),f=e({links:[r({client:m})]});try{let e=await f.getEditorScene.mutate(),t=JSON.stringify(e,null,p?2:void 0);if(n.output){let e=i(n.output);await o(e,t,"utf-8"),l.success(`Scene saved: ${e}`)}else console.log(t)}catch(e){if(e instanceof Error){let t=e.cause;null!=t&&"object"==typeof t&&"code"in t&&"ECONNREFUSED"===t.code&&(l.error("Dev server not running. Start with `phoenix dev`"),process.exit(1)),l.error(e.message)}else l.error(`Scene command failed: ${String(e)}`);process.exit(1)}finally{await m.close()}};
+import{createTRPCClient as e,createWSClient as t,wsLink as r}from"@trpc/client";import{writeFile as o}from"fs/promises";import{resolve as i}from"path";import n from"ws";import{exitCli as s}from"../services/index.js";export const runSceneCommand=async(a,c)=>{let{logger:l}=c,m=a.port??"3020",f=a.pretty??!0,p=t({url:`ws://localhost:${m}`,WebSocket:n}),u=e({links:[r({client:p})]});try{let e=await u.getEditorScene.mutate(),t=JSON.stringify(e,null,f?2:void 0);if(a.output){let e=i(a.output);await o(e,t,"utf-8"),l.success(`Scene saved: ${e}`)}else console.log(t)}catch(e){if(e instanceof Error){let t=e.cause;if(null!=t&&"object"==typeof t&&"code"in t&&"ECONNREFUSED"===t.code){l.error("Dev server not running. Start with `phoenix dev`"),await s(1);return}l.error(e.message)}else l.error(`Scene command failed: ${String(e)}`);await s(1)}finally{await p.close()}};

package/dist/phoenix/commands/screenshot.js

@@ -1 +1 @@
-import{createTRPCClient as e,createWSClient as t,wsLink as r}from"@trpc/client";import{resolve as o}from"path";import s from"ws";export const runScreenshotCommand=async(n,c)=>{let{logger:i}=c,a=n.port??"3020",l=n.output??"./screenshot.png",p=n.width??1920,h=n.height??1080,m=n.format?.toUpperCase()??"PNG";"PNG"!==m&&"JPEG"!==m&&(i.error(`Invalid format: ${m}. Use PNG or JPEG`),process.exit(1));let f=t({url:`ws://localhost:${a}`,WebSocket:s}),u=e({links:[r({client:f})]});try{let e=await u.takeScreenshot.mutate({width:p,height:h,fileFormat:m,output:o(l)});console.log(`Screenshot saved: ${e.filePath}`)}catch(e){if(e instanceof Error){let t=e.cause;null!=t&&"object"==typeof t&&"code"in t&&"ECONNREFUSED"===t.code&&(i.error("Dev server not running. Start with `phoenix dev`"),process.exit(1)),i.error(e.message)}else i.error(`Screenshot failed: ${String(e)}`);process.exit(1)}finally{await f.close()}};
+import{createTRPCClient as e,createWSClient as t,wsLink as r}from"@trpc/client";import{resolve as o}from"path";import a from"ws";import{exitCli as i}from"../services/index.js";export const runScreenshotCommand=async(n,s)=>{let{logger:c}=s,l=n.port??"3020",p=n.output??"./screenshot.png",f=n.width??1920,h=n.height??1080,m=n.format?.toUpperCase()??"PNG";if("PNG"!==m&&"JPEG"!==m){c.error(`Invalid format: ${m}. Use PNG or JPEG`),await i(1);return}let u=t({url:`ws://localhost:${l}`,WebSocket:a}),d=e({links:[r({client:u})]});try{let e=await d.takeScreenshot.mutate({width:f,height:h,fileFormat:m,output:o(p)});console.log(`Screenshot saved: ${e.filePath}`)}catch(e){if(e instanceof Error){let t=e.cause;if(null!=t&&"object"==typeof t&&"code"in t&&"ECONNREFUSED"===t.code){c.error("Dev server not running. Start with `phoenix dev`"),await i(1);return}c.error(e.message)}else c.error(`Screenshot failed: ${String(e)}`);await i(1)}finally{await u.close()}};

package/dist/phoenix/commands/state.js

@@ -1 +1 @@
-import{createTRPCClient as t,createWSClient as e,wsLink as o}from"@trpc/client";import{writeFile as r}from"fs/promises";import{resolve as i}from"path";import s from"ws";let n=["entities","navigation","validation"];export const runStateCommand=async(a,l)=>{let{logger:c}=l,p=a.port??"3020",m=a.pretty??!0,f=a.sections?a.sections.split(",").map(t=>t.trim()):[...n],u=f.filter(t=>!n.includes(t));u.length>0&&(c.error(`Invalid sections: ${u.join(", ")}. Valid: ${n.join(", ")}`),process.exit(1));let d=e({url:`ws://localhost:${p}`,WebSocket:s}),S=t({links:[o({client:d})]});try{let t=await S.getEditorState.mutate({sections:f}),e=JSON.stringify(t,null,m?2:void 0);if(a.output){let t=i(a.output);await r(t,e,"utf-8"),c.success(`State saved: ${t}`)}else console.log(e)}catch(t){if(t instanceof Error){let e=t.cause;null!=e&&"object"==typeof e&&"code"in e&&"ECONNREFUSED"===e.code&&(c.error("Dev server not running. Start with `phoenix dev`"),process.exit(1)),c.error(t.message)}else c.error(`State command failed: ${String(t)}`);process.exit(1)}finally{await d.close()}};
+import{createTRPCClient as t,createWSClient as e,wsLink as i}from"@trpc/client";import{writeFile as r}from"fs/promises";import{resolve as o}from"path";import a from"ws";import{exitCli as n}from"../services/index.js";let s=["entities","navigation","validation"];export const runStateCommand=async(l,c)=>{let{logger:m}=c,f=l.port??"3020",p=l.pretty??!0,u=l.sections?l.sections.split(",").map(t=>t.trim()):[...s],d=u.filter(t=>!s.includes(t));if(d.length>0){m.error(`Invalid sections: ${d.join(", ")}. Valid: ${s.join(", ")}`),await n(1);return}let v=e({url:`ws://localhost:${f}`,WebSocket:a}),w=t({links:[i({client:v})]});try{let t=await w.getEditorState.mutate({sections:u}),e=JSON.stringify(t,null,p?2:void 0);if(l.output){let t=o(l.output);await r(t,e,"utf-8"),m.success(`State saved: ${t}`)}else console.log(e)}catch(t){if(t instanceof Error){let e=t.cause;if(null!=e&&"object"==typeof e&&"code"in e&&"ECONNREFUSED"===e.code){m.error("Dev server not running. Start with `phoenix dev`"),await n(1);return}m.error(t.message)}else m.error(`State command failed: ${String(t)}`);await n(1)}finally{await v.close()}};

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

@@ -1,3 +1,3 @@
-import r from"promise-queue";import{generateApplicationSpecStory as e}from"../application-spec/generate-application-spec-story.js";import{resolveGlobToDirectories as o}from"./resolve-story-directories.js";export const buildStoryInDirectory=async(r,o)=>{let{logger:t}=o;t.step(`Building Storybook example in ${r.targetDir}`),await e(r.targetDir,o),t.success(`Completed building Storybook example in ${r.targetDir}`)};export const runStoryBuildCommand=async(e,t)=>{let{logger:i}=t;try{let s=await o(e.folder,e.baseDir);if(0===s.length){let r=e.baseDir?`${e.baseDir}/${e.folder}`:e.folder;i.error(`No directories found matching pattern: ${r}. The pattern did not match any directories in the base directory, ensure the base directory exists and contains matching folders.`),process.exit(1)}console.log(`
-Found ${s.length} matching ${1===s.length?"directory":"directories"}:
-`),s.forEach(r=>{console.log(`  - ${r}`)}),console.log("");let n=new r(4,1/0),a=[];if(await Promise.all(s.map(async r=>{try{await n.add(()=>buildStoryInDirectory({targetDir:r},t)),console.log("")}catch(e){i.error(`Failed to build story in ${r}: ${e instanceof Error?e.message:String(e)}`),console.log(e),a.push({dir:r,error:e instanceof Error?e:Error(String(e))})}})),a.length>0)throw i.error(`Failed to build ${a.length} ${1===a.length?"story":"stories"}:`),a.forEach(r=>{i.error(`  - ${r.dir}: ${r.error.message}`)}),Error("Failed to build stories");i.success(`Completed building ${s.length} ${1===s.length?"story":"stories"}!`)}catch(r){throw i.error(`Story build failed: ${r instanceof Error?r.message:String(r)}`),r}};
+import r from"promise-queue";import{generateApplicationSpecStory as e}from"../application-spec/generate-application-spec-story.js";import{exitCli as o}from"../services/index.js";import{resolveGlobToDirectories as t}from"./resolve-story-directories.js";export const buildStoryInDirectory=async(r,o)=>{let{logger:t}=o;t.step(`Building Storybook example in ${r.targetDir}`),await e(r.targetDir,o),t.success(`Completed building Storybook example in ${r.targetDir}`)};export const runStoryBuildCommand=async(e,i)=>{let{logger:s}=i;try{let n=await t(e.folder,e.baseDir);if(0===n.length){let r=e.baseDir?`${e.baseDir}/${e.folder}`:e.folder;s.error(`No directories found matching pattern: ${r}. The pattern did not match any directories in the base directory, ensure the base directory exists and contains matching folders.`),await o(1);return}console.log(`
+Found ${n.length} matching ${1===n.length?"directory":"directories"}:
+`),n.forEach(r=>{console.log(`  - ${r}`)}),console.log("");let a=new r(4,1/0),l=[];if(await Promise.all(n.map(async r=>{try{await a.add(()=>buildStoryInDirectory({targetDir:r},i)),console.log("")}catch(e){s.error(`Failed to build story in ${r}: ${e instanceof Error?e.message:String(e)}`),console.log(e),l.push({dir:r,error:e instanceof Error?e:Error(String(e))})}})),l.length>0)throw s.error(`Failed to build ${l.length} ${1===l.length?"story":"stories"}:`),l.forEach(r=>{s.error(`  - ${r.dir}: ${r.error.message}`)}),Error("Failed to build stories");s.success(`Completed building ${n.length} ${1===n.length?"story":"stories"}!`)}catch(r){throw s.error(`Story build failed: ${r instanceof Error?r.message:String(r)}`),r}};

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

@@ -1 +1 @@
-import{basename as r,join as e}from"path";import{generateInitialStory as t}from"../story-scaffolding/index.js";import{askQuestion as o,exists as s,toPascalCase as a}from"../utils/index.js";import{buildStoryInDirectory as i}from"./story-build.js";export const runStoryCreateCommand=async(n={},c)=>{let{logger:m}=c;try{m.step("Creating new Storybook example");let y=n.name;if(!y)for(;!y;){let r=await o('Enter the story name (e.g., "my-feature" or "MyFeature"): ');if(!r||0===r.trim().length){m.error("Story name is required");continue}if(!/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(r)){m.error("Story name must start with a letter and contain only letters, numbers, hyphens, and underscores");continue}y=r.trim()}y||(m.error("Story name is required"),process.exit(1)),await s(e(process.cwd(),`src/${y}`))&&(m.error(`Story ${y} already exists`),process.exit(1));let l=e(process.cwd(),`src/examples/${y}`),d=a(r(l));await t(l,d),await i({targetDir:l},c),m.success(`Story created successfully in ${l}!`)}catch(r){m.error(`Story creation failed: ${r instanceof Error?r.message:String(r)}`,r),process.exit(1)}};
+import{basename as r,join as e}from"path";import{exitCli as t}from"../services/index.js";import{generateInitialStory as a}from"../story-scaffolding/index.js";import{askQuestion as o,exists as i,toPascalCase as s}from"../utils/index.js";import{buildStoryInDirectory as n}from"./story-build.js";export const runStoryCreateCommand=async(m={},c)=>{let{logger:y}=c;try{y.step("Creating new Storybook example");let f=m.name;if(!f)for(;!f;){let r=await o('Enter the story name (e.g., "my-feature" or "MyFeature"): ');if(!r||0===r.trim().length){y.error("Story name is required");continue}if(!/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(r)){y.error("Story name must start with a letter and contain only letters, numbers, hyphens, and underscores");continue}f=r.trim()}if(!f){y.error("Story name is required"),await t(1);return}if(await i(e(process.cwd(),`src/${f}`))){y.error(`Story ${f} already exists`),await t(1);return}let l=e(process.cwd(),`src/examples/${f}`),u=s(r(l));await a(l,u),await n({targetDir:l},c),y.success(`Story created successfully in ${l}!`)}catch(r){y.error(`Story creation failed: ${r instanceof Error?r.message:String(r)}`,r),await 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 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()}};
+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{PhoenixApplication as n,STORY_DEV_MARKER_PATH as l,readActiveStoryDevMarker as c}from"../services/index.js";import{resolveGlobToDirectories as d}from"./resolve-story-directories.js";import{runStoryBuildCommand as f}from"./story-build.js";let p=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},g=async(e,o)=>{let t=await d(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 p(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),g=()=>r(c,{force:!0});process.once("exit",g);let m=new n({projectRoot:s,mode:"story",development:void 0,editorPort:i},{logger:o.logger,createEditorServer:a,onProjectPrepared:()=>{},onStartupFailure:()=>{},onBrowserConsole:()=>{}}),y=!1,u=async()=>{y||(y=!0,process.off("exit",g),await m.close(),r(c,{force:!0}))};try{return o.logger.step(`Building application-spec story in ${s}`),await f({folder:s,baseDir:e.baseDir},o),await m.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:u}}catch(e){throw await u(),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 g(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/sync.d.ts

@@ -1,10 +1,11 @@
+import type { PageExperience } from '#package/application-spec';
 import type { CommandContext } from './types.js';
 export interface SyncCommandProps {
     readonly sdkVersion: string;
     readonly projectSlug: string;
     readonly environmentSlug: string;
     readonly cliUseWorkspace?: boolean;
-    readonly enableEditor?: boolean;
+    readonly pageExperience: PageExperience;
     readonly force?: boolean;
     readonly analyze?: boolean;
 }

package/dist/phoenix/commands/sync.js

@@ -1 +1 @@
-import{ensureWorkspaceInstallSettings as e,runCommand as s}from"../utils/index.js";import{generateProjectFilesAndInstallDependencies as c}from"./generate-project-files.js";export const runSyncCommand=async(t,i)=>{let{logger:r}=i,{sdkVersion:n,projectSlug:o,environmentSlug:l,cliUseWorkspace:a,enableEditor:p,force:m=!1,analyze:u=!1}=t;try{r.step("Syncing Phoenix project files"),e(process.cwd()),await s({command:"pnpm",args:["install"],description:"Installing packages",quiet:!0},{logger:r}),r.step("Building project files"),await c({sdkVersion:n,projectSlug:o,environmentSlug:l,cliUseWorkspace:a,enableEditor:p,inlineTemplates:!0,force:m,analyze:u},i),r.success("Project files built successfully"),r.success("Sync completed successfully!")}catch(e){r.error(`Sync failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};
+import{generateProjectFiles as e,logDiagnostics as s}from"../application-spec/index.js";import{exitCli as c}from"../services/index.js";export const runSyncCommand=async(i,t)=>{let{logger:r}=t,{sdkVersion:n,projectSlug:o,environmentSlug:l,cliUseWorkspace:a,pageExperience:p,force:f=!1,analyze:m=!1}=i;try{r.step("Syncing Phoenix project files"),r.step("Building project files");let{diagnostics:c}=await e({sdkVersion:n,projectSlug:o,environmentSlug:l,cliUseWorkspace:a,pageExperience:p,inlineTemplates:"agent"!==p,force:f,analyze:m},t);s(c,r),r.success("Project files built successfully"),r.success("Sync completed successfully!")}catch(e){r.error(`Sync failed: ${e instanceof Error?e.message:String(e)}`,e),await c(1)}};

package/dist/phoenix/commands/unlink.js

@@ -1 +1 @@
-import{getLocalOverrides as n,removeWorkspaceOverrides as e,runCommand as i}from"../utils/index.js";export const runUnlinkCommand=async a=>{let{logger:s}=a;try{s.step("Unlinking local SDK packages");let a=n();if(0===a.length)return void s.info("No linked SDK packages found");s.debug(`Found ${a.length} linked packages`),a.forEach(n=>{s.debug(`  Unlinked ${n}`)}),e(a),s.success(`Unlinked ${a.length} SDK packages`),await i({command:"pnpm",args:["install","--config.optimistic-repeat-install=false"],description:"Installing packages",quiet:!0},{logger:s}),s.info("\nNext step:"),s.info("  Run: phoenix dev")}catch(n){throw s.error(`Failed to unlink SDK packages: ${n instanceof Error?n.message:String(n)}. pnpm-workspace.yaml may be missing or invalid. Check that an overrides section exists in pnpm-workspace.yaml.`),n}};
+import{assertPnpmProject as n,getLocalOverrides as e,removeWorkspaceOverrides as r}from"../utils/index.js";export const runUnlinkCommand=async o=>{let{logger:i}=o;try{n({projectRoot:process.cwd(),command:"unlink"})}catch(n){throw i.error(n instanceof Error?n.message:String(n)),n}try{i.step("Unlinking local SDK packages");let n=e();if(0===n.length)return void i.info("No linked SDK packages found");i.debug(`Found ${n.length} linked packages`),n.forEach(n=>{i.debug(`  Unlinked ${n}`)}),r(n),i.success(`Unlinked ${n.length} SDK packages`),i.info("\nNext steps:\n  pnpm install --config.optimistic-repeat-install=false\n  phoenix dev")}catch(n){throw i.error(`Failed to unlink SDK packages: ${n instanceof Error?n.message:String(n)}. pnpm-workspace.yaml may be missing or invalid. Check that an overrides section exists in pnpm-workspace.yaml.`),n}};

package/dist/phoenix/commands/variants.js

@@ -1 +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)}};
+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{exitCli as w}from"../services/index.js";import{toPosixPath as m}from"../utils/path.js";let u=".phoenix",v="variants",g=".variant.js",y=".html",$={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&#39;":"'"},b=e=>{let t=e?.trim();return""===t?void 0:t},C=e=>b(e?.replace(/&(?:amp|lt|gt|quot|#39);/g,e=>$[e]??e)),E=(e,t)=>{let o=e.match(RegExp(`export\\s+const\\s+${t}\\s*=\\s*(['"\`])((?:\\\\.|(?!\\1).)*)\\1`))?.[2];return b(o?.replace(/\\(.)/g,"$1"))};export const readVariantSet=e=>{let t=d(e.projectRoot,u),o=c(t,v),a=d(e.projectRoot,e.directory),f=p(o,a),w=`${u}/${v}/<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 ${u}/${v}/. Write the option files to ${w} and pass that folder`);if(!r(a)||!s(a).isDirectory())throw Error(`Cannot preview ${e.directory}: there is no such folder. Write one ${g} or ${y} file per option to ${w} first`);let $=n(a),b=Math.round(Math.max(0,...$.map(e=>s(c(a,e)).mtimeMs))),x=$.filter(e=>e.endsWith(g)||e.endsWith(y)).sort().map(e=>(e=>{let{webRoot:t,directory:o,name:r,version:n}=e,a=c(o,r),s=i(a,"utf8"),l=`/${m(p(t,a)).split("/").map(encodeURIComponent).join("/")}`,d=r.endsWith(g),h=r.slice(0,-(d?g:y).length),f=s.match(/<meta\b[^>]*\bname=(["'])description\1[^>]*>/i)?.[0];return{id:h,kind:d?"script":"page",label:(d?E(s,"title"):C(s.match(/<title[^>]*>([^<]*)<\/title>/i)?.[1]))??h,description:(d?E(s,"description"):C(f?.match(/\bcontent=(["'])(.*?)\1/i)?.[2]))??"",url:`${l}?t=${n}`}})({webRoot:t,directory:a,name:e,version:b}));if(0===x.length)throw Error(`Cannot preview ${e.directory}: it holds no ${g} or ${y} 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 x=r=>{let i=t({url:`ws://localhost:${r}`,WebSocket:f});return{wsClient:i,client:e({links:[o({client:i})]})}},R=e=>{console.log(JSON.stringify(e,null,2))},j=async e=>{let{wsClient:t,client:o}=x(e);try{let{closed:e}=await o.closeVariantPreview.mutate();R({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}=x(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 R({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 R({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(R({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 j(e.port);if(void 0===e.directory)throw Error(`Cannot preview without a folder: the options to show are read from it. Pass ${u}/${v}/<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)),await w(1)}};

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 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)})});
+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 c=i.enum(["all",...u]),b=e=>{if(!e.application.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.application.variantPreviews};export const commandsRouter=l({getLogs:a.input(i.object({stream:c,beforeSeq:i.number().int().positive().optional(),limit:i.number().int().positive().max(500).default(200)})).query(({input:e,ctx:t})=>{if(!t.application.logs)return{entries:[],hasMore:!1,counts:null};let r=t.application.logs.query(e);return{entries:r.entries,hasMore:r.hasMore,counts:t.application.logs.allCounts()}}),onLog:a.subscription(({ctx:t})=>e(e=>t.application.logs?t.application.logs.subscribe(t=>{e.next(t)}):()=>{})),getTunnelState:a.query(({ctx:e})=>e.application.tunnelMonitor?{state:e.application.tunnelMonitor.state(),entries:e.application.tunnelMonitor.summaries()}:{state:null,entries:[]}),getTunnelRequest:a.input(i.object({seq:i.number().int().positive()})).query(({ctx:e,input:t})=>e.application.tunnelMonitor?.entry(t.seq)??null),onTunnelEvent:a.subscription(({ctx:t})=>e(e=>t.application.tunnelMonitor?t.application.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 c=r(e.output),b=Buffer.from(u.imageBase64,"base64");try{await t(c,b)}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(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.application.logs){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})=>b(t).open(e)),onVariantPreview:a.subscription(({ctx:t})=>e(e=>{let r=t.application.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})=>b(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})=>b(t).applyFiles(e)),submitVariantChoice:a.input(i.object({requestId:i.string(),choice:i.string().nullable()})).mutation(({input:e,ctx:t})=>b(t).submit(e)),closeVariantPreview:a.mutation(({ctx:e})=>e.application.variantPreviews?.close()??Promise.resolve({closed:!1})),claimVariantChoice:a.input(i.object({requestId:i.string()})).mutation(({input:e,ctx:t})=>{t.application.variantPreviews?.claim(e.requestId)})});

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

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

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

@@ -1 +1 @@
-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()})}))}};
+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:t,application:n,logger:i})=>{let s=new o({port:t}),c=e({wss:s,router:r,createContext:()=>({projectRoot:n.projectRoot,pubsub:n.pubsub,application:n,logger:i})});s.on("connection",(e,o)=>{let r=o.headers.origin??"unknown";i.info(`WS connected (clients: ${s.clients.size}, origin: ${r})`),e.on("error",e=>{i.warn(`WS error: ${e.message}`)}),e.once("close",(e,o)=>{i.info(`WS disconnected (clients: ${s.clients.size}, code: ${e}, reason: ${o.toString()||"none"})`)})}),s.on("error",e=>{i.error(`WebSocket server error: ${e.message}`)});let l=new Promise((e,o)=>{let r=()=>{s.off("error",n),i.info(`WebSocket Server listening on ws://localhost:${t}`),e()},n=e=>{s.off("listening",r),o(e)};s.once("listening",r),s.once("error",n)}),a=null;return{ready:l,close:()=>a||(i.info("Shutting down WebSocket server"),c.broadcastReconnectNotification(),a=new Promise((e,o)=>{let r=setTimeout(()=>{for(let e of s.clients)e.terminate()},3e3);s.close(t=>{clearTimeout(r),t?o(t):e()})}))}};

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 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()}}))});
+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 i}from"path";import{z as r}from"zod";import{readApplicationFiles as p}from"../application-spec/index.js";import{exists as a}from"../utils/index.js";import{publicProcedure as s,router as n}from"./trpc.js";export const specRouter=n({getEditorConfig:s.query(()=>({specSync:!0})),prepareDeployment:s.mutation(async({ctx:o})=>{if(o.application.variantPreviews?.isOpen)throw new e({code:"BAD_REQUEST",message:"Deployment preparation is disabled during variant previews. Close the preview first."});if("story"===o.application.mode)throw new e({code:"BAD_REQUEST",message:"Deployment preparation is disabled in Storybook story mode."});if(!o.application.deploymentPreparation)throw new e({code:"BAD_REQUEST",message:"Deployment preparation requires a deployment configuration outside story mode."});await o.application.deploymentPreparation.prepare()}),requestSpecFiles:s.mutation(async({ctx:e})=>{let o="story"===e.application.mode?await p({projectRoot:e.projectRoot,envs:{}}):await p();e.pubsub.specFile$.next({rawProjectFiles:o,projectRoot:e.projectRoot})}),save:s.input(r.array(r.object({fileName:r.string(),content:r.string()}))).mutation(async({ctx:o,input:r})=>{if(o.application.variantPreviews?.isOpen)throw new e({code:"BAD_REQUEST",message:"Close the variant preview before editing source files."});for(let e of r){let r=i(o.projectRoot,e.fileName),p=i(o.projectRoot,e.fileName.split("/").slice(0,-1).join("/"));await a(p)&&await t(r,e.content)}}),onSpecChange:s.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,21 +1,11 @@
-import type { LogBus } from '../services/log-bus.js';
+import type { PhoenixApplication } from '../services/index.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;
-    /** Dev-server log buffer backing the editor Logs panel; absent in story mode. */
-    readonly logBus?: LogBus;
-    /** Dev-process tunnel state backing the editor Webhook Tunnel panel. */
-    readonly tunnelMonitor?: WebhookTunnelMonitor;
+    readonly application: PhoenixApplication;
 };
 export declare const router: import("@trpc/server").TRPCRouterBuilder<{
     ctx: Context;

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

@@ -0,0 +1 @@
+export { LINGUI_CONFIG_PATH, bootstrapLinguiCatalogs, compileLingui, extractAndCompileLingui } from './lingui.js';

package/dist/phoenix/lingui/index.js

@@ -0,0 +1 @@
+export{LINGUI_CONFIG_PATH,bootstrapLinguiCatalogs,compileLingui,extractAndCompileLingui}from"./lingui.js";

package/dist/phoenix/lingui/lingui.d.ts

@@ -0,0 +1,18 @@
+import { type Logger } from '../utils/index.js';
+/**
+ * The project's Lingui configuration, which sync generates, relative to the project root. The Lingui
+ * CLI is given this path and Vite loads its plugins from a fresh snapshot of this file, so a
+ * `.linguirc` that earlier SDK versions left in the project root is not read. The Lingui CLI searches
+ * the working directory instead only when the named file is missing; generation writes it with the rest
+ * of `.phoenix/` before Phoenix runs Lingui or Vite. Missing-catalog bootstrap compiles with a temporary
+ * copy that stages output while keeping every locale available for fallback reads.
+ */
+export declare const LINGUI_CONFIG_PATH = ".phoenix/.linguirc";
+interface LinguiCommandContext {
+    readonly logger: Logger;
+}
+export declare const compileLingui: (context: LinguiCommandContext) => Promise<void>;
+export declare const extractAndCompileLingui: (context: LinguiCommandContext) => Promise<void>;
+/** Creates only catalogs missing from a project's generated domain imports; continuous updates stay opt-in. */
+export declare const bootstrapLinguiCatalogs: (locales: readonly string[], context: LinguiCommandContext) => Promise<void>;
+export {};

package/dist/phoenix/lingui/lingui.js

@@ -0,0 +1 @@
+import{constants as i}from"node:fs";import{copyFile as a,mkdir as t,mkdtemp as e,readFile as o,rm as n,writeFile as s}from"node:fs/promises";import{dirname as r,join as l}from"node:path";import{exists as c,runSdkTool as g}from"../utils/index.js";export const LINGUI_CONFIG_PATH=".phoenix/.linguirc";let p=async i=>{await g({tool:{packageName:"@lingui/cli",binName:"lingui"},args:["extract","--config",LINGUI_CONFIG_PATH],description:"Extracting i18n messages",quiet:!0,extraEnv:{LC_ALL:"en_US.UTF-8"}},i)};export const compileLingui=async i=>{await g({tool:{packageName:"@lingui/cli",binName:"lingui"},args:["compile","--config",LINGUI_CONFIG_PATH],description:"Compiling i18n messages",quiet:!0},i)};export const extractAndCompileLingui=async i=>{await p(i),await compileLingui(i)};export const bootstrapLinguiCatalogs=async(p,m)=>{let u,f=(await Promise.all(p.map(async i=>await c(`src/locales/${i}/messages.ts`)?[]:[i]))).flat();if(0!==f.length)try{m.logger.info(`Bootstrapping missing i18n catalogs: ${f.join(", ")}`);let n=(await Promise.all(f.map(async i=>await c(`src/locales/${i}/messages.po`)?[]:[i]))).flat();n.length>0&&await g({tool:{packageName:"@lingui/cli",binName:"lingui"},args:["extract","--config",LINGUI_CONFIG_PATH,"--locale",n.join(",")],description:"Extracting missing i18n catalogs",quiet:!0,extraEnv:{LC_ALL:"en_US.UTF-8"}},m);let p=JSON.parse(await o(LINGUI_CONFIG_PATH,"utf-8"));if("object"!=typeof p||null===p||Array.isArray(p))throw Error(`${LINGUI_CONFIG_PATH} is not a configuration object`);u=await e(".phoenix/lingui-bootstrap-");let N=l(u,".linguirc");for(let e of(await s(N,JSON.stringify({...p,catalogsMergePath:l(u,"compiled","{locale}","messages").replaceAll("\\","/")})),await g({tool:{packageName:"@lingui/cli",binName:"lingui"},args:["compile","--config",N],description:"Compiling missing i18n catalogs",quiet:!0},m),f)){let o=l("src","locales",e,"messages.ts");await t(r(o),{recursive:!0}),await a(l(u,"compiled",e,"messages.ts"),o,i.COPYFILE_EXCL)}}catch(i){throw Error(`Cannot bootstrap i18n catalogs for ${f.join(", ")}: ${i instanceof Error?i.message:String(i)}. Fix the reported Lingui error and restart phoenix dev, or run phoenix sync to update all catalogs.`,{cause:i})}finally{void 0!==u&&await n(u,{recursive:!0,force:!0})}};

package/dist/phoenix/scripts/docs-utils.js

@@ -1 +1 @@
-import{existsSync as t,readFileSync as e,readdirSync as r,statSync as s}from"fs";import{convertPathToPattern as o,globby as i}from"globby";import{dirname as n,join as a,resolve as l}from"path";import{fileURLToPath as p}from"url";let c=n(p(import.meta.url));export const PROJECT_SDK_ROOT=l(c,"../../..");export const MONOREPO_ROOT=l(PROJECT_SDK_ROOT,"../../..");export const DIST_DOCS=a(PROJECT_SDK_ROOT,"dist/docs");let m=a(MONOREPO_ROOT,"packages/apps/storybook");export const STORYBOOK_SRC=a(m,"src");export const STORYBOOK_EXAMPLES=a(STORYBOOK_SRC,"examples");export const UI_SDK_SRC=a(PROJECT_SDK_ROOT,"src/ui-sdk");let u=a(m,".storybook/preview.tsx"),f=/order:\s*\[/;export const parseTopCategoriesFromPreview=t=>{let e=f.exec(t);if(!e)return[];let r=0,s=e.index+e[0].length-1,o=[],i="",n=!1,a="";for(;s<t.length;s++){let e=t[s];if("["===e&&!n){r++;continue}if("]"===e&&!n){if(0==--r)break;continue}if(1===r){if(("'"===e||'"'===e)&&!n){n=!0,a=e,i="";continue}if(e===a&&n){n=!1,"*"!==i&&o.push(i);continue}n&&(i+=e)}}return o};export const buildCategoryCaseMap=t=>new Map(t.map(t=>[t.toLowerCase(),t]));export const loadDocsConfig=()=>{let t=e(u,"utf-8"),r=parseTopCategoriesFromPreview(t),s=buildCategoryCaseMap(r);return{topCategories:r,caseMap:s}};export const discoverMdxFiles=async()=>i([`${o(STORYBOOK_SRC)}/**/*.mdx`,`${o(UI_SDK_SRC)}/**/*.mdx`],{absolute:!0});export const getSource=t=>t.startsWith(STORYBOOK_EXAMPLES)?"storybook-example":t.startsWith(STORYBOOK_SRC)?"storybook-root":t.startsWith(UI_SDK_SRC)?"ui-sdk":"unknown";let g=/<Meta\s+title=["']([^"']+)["']\s*\/?>/,x=/<Meta\s+of=\{(\w+)\}\s*\/?>/,h=/title:\s*['"]([^'"]+)['"]/;export const parseMdxTitle=t=>{let e=g.exec(t);return e?.[1]};export const parseStoriesTitle=t=>{let e=h.exec(t);return e?.[1]};export const resolveStoriesPath=(e,r)=>{let s=x.exec(r);if(!s)return;let o=s[1],i=r.match(RegExp(`import\\s+\\*\\s+as\\s+${o}\\s+from\\s+['"]([^'"]+)['"]`));if(!i?.[1])return;let a=l(n(e),i[1]);if(!a.endsWith(".tsx")&&!a.endsWith(".ts"))if(t(a+".tsx"))a+=".tsx";else{if(!t(a+".ts"))return;a+=".ts"}return t(a)?a:void 0};export const resolveTitle=(t,r)=>{let s=parseMdxTitle(r);if(s)return s;let o=resolveStoriesPath(t,r);if(!o)return;let i=e(o,"utf-8");return parseStoriesTitle(i)};export const findFirstParagraph=t=>{let e=t.split("\n"),r=[],s=!1,o=!1;for(let t of e){let e=t.trim();if(e.startsWith("```")){o=!o;continue}if(!(o||e.startsWith("- [")||e.startsWith("* [")||e.startsWith("#")||e.startsWith("<")||e.startsWith("{/*")||e.startsWith("|"))&&!e.startsWith(">")){if(""===e){if(s&&r.length>0)break;continue}s=!0,r.push(e)}}return r.length>0?r.join(" "):void 0};export const truncateAtWord=(t,e)=>{if(t.length<=e)return t;let r=t.slice(0,e),s=r.lastIndexOf(" ");return(s>0?r.slice(0,s):r)+"..."};export const extractDescription=t=>{let e=t.split("\n").filter(t=>!t.startsWith("import ")).filter(t=>!t.startsWith("<Meta")).filter(t=>!t.startsWith("<Canvas")).filter(t=>!t.startsWith("<Story")).filter(t=>!t.startsWith("<Controls")).filter(t=>!t.startsWith("<Markdown")).join("\n"),r=/^# .+$/m.exec(e),s=/^## .+$/m.exec(e),o=r?r.index+r[0].length:0,i=s?s.index:e.length,n=e.slice(o,i),a=findFirstParagraph(n);if(!a&&s){let t=e.slice(s.index+s[0].length),r=/^## .+$/m.exec(t),o=r?t.slice(0,r.index):t;a=findFirstParagraph(o)}return a?truncateAtWord(a,200):""};export const parseCategoryPath=t=>{let e=t.split(/\s*\/\s*/).map(t=>t.trim()).filter(Boolean);return 0===e.length?["Uncategorized"]:e};export const normalizeTopCategory=(t,e)=>e.get(t.toLowerCase())??t;export const slugify=t=>t.toLowerCase().replace(/&/g,"and").replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"");export const computeOutputPath=(t,e)=>{let r=t.slice(0,-1).map(slugify).join("/"),s=`${e}.mdx`;return r?`${r}/${s}`:s};export const resolveDocMeta=(t,e)=>{let r=parseCategoryPath(t),s=r[0],o=r[r.length-1];if(!s||!o)return;let i=[normalizeTopCategory(s,e),...r.slice(1)],n=slugify(o),a=computeOutputPath(i,n);return{title:t,lastSegment:o,normalizedSegments:i,docSlug:n,outputRelative:a}};let d=[/^import\s+\{[^}]*\}\s+from\s+['"]@storybook\/[^'"]+['"]\s*$/gm,/^import\s+\*\s+as\s+\w+\s+from\s+['"][^'"]*\.stories[^'"]*['"]\s*$/gm,/^import\s+\w+\s+from\s+['"][^'"]*\.stories[^'"]*['"]\s*$/gm,/^import\s+\w+\s+from\s+['"][^'"]*\.mdx[^'"]*['"]\s*$/gm,/^import\s+\w+\s+from\s+['"][^'"]*\?raw['"]\s*$/gm,/^<Meta\s+[^>]*\/>\s*$/gm,/^<Canvas\s+[^>]*\/>\s*$/gm,/^<Story\s+[^>]*\/>\s*$/gm,/^<Controls\s+[^>]*\/>\s*$/gm,/^<Markdown>\{[^}]+\}<\/Markdown>\s*$/gm];export const stripStorybookImports=t=>{let e=t;for(let t of d)e=e.replace(t,"");return e.replace(/\n{3,}/g,"\n\n").trim()+"\n"};export const buildCategoryTree=(t,e,r)=>{let s=new Map,o=(t,e)=>{let r=t.get(e);return r||(r={name:e,docs:[],subcategories:new Map},t.set(e,r)),r};for(let e of t){let t=e.category,i=t[0];if(0===t.length||!i)continue;let n=o(s,normalizeTopCategory(i,r));if(1===t.length){n.docs.push(e);continue}let a=n;for(let e=1;e<t.length-1;e++){let r=t[e];r&&(a=o(a.subcategories,r))}a.docs.push(e)}let i=new Map(e.map((t,e)=>[t,e])),n=t=>({name:t.name,docs:t.docs,subcategories:Array.from(t.subcategories.values()).map(n)});return Array.from(s.values()).sort((t,e)=>(i.get(t.name)??999)-(i.get(e.name)??999)||t.name.localeCompare(e.name)).map(n)};export const getDirectorySizeBytes=t=>{let e=0;for(let o of r(t,{withFileTypes:!0})){let r=a(t,o.name);o.isDirectory()?e+=getDirectorySizeBytes(r):e+=s(r).size}return e};export const formatBytes=t=>{if(t<1024)return`${t} B`;let e=t/1024;if(e<1024)return`${e.toFixed(1)} KB`;let r=e/1024;return`${r.toFixed(1)} MB`};
+import{existsSync as t,readFileSync as e,readdirSync as r,statSync as s}from"fs";import{convertPathToPattern as o,globby as i}from"globby";import{dirname as n,join as a,resolve as l}from"path";import{fileURLToPath as p}from"url";let c=n(p(import.meta.url));export const PROJECT_SDK_ROOT=l(c,"../../..");export const MONOREPO_ROOT=l(PROJECT_SDK_ROOT,"../../..");export const DIST_DOCS=a(PROJECT_SDK_ROOT,"dist/docs");let m=a(MONOREPO_ROOT,"packages/apps/storybook");export const STORYBOOK_SRC=a(m,"src");export const STORYBOOK_EXAMPLES=a(STORYBOOK_SRC,"examples");export const UI_SDK_SRC=a(PROJECT_SDK_ROOT,"src/ui-sdk");let f=a(m,".storybook/preview.tsx"),u=/order:\s*\[/;export const parseTopCategoriesFromPreview=t=>{let e=u.exec(t);if(!e)return[];let r=0,s=e.index+e[0].length-1,o=[],i="",n=!1,a="";for(;s<t.length;s++){let e=t[s];if("["===e&&!n){r++;continue}if("]"===e&&!n){if(0==--r)break;continue}if(1===r){if(("'"===e||'"'===e)&&!n){n=!0,a=e,i="";continue}if(e===a&&n){n=!1,"*"!==i&&o.push(i);continue}n&&(i+=e)}}return o};export const buildCategoryCaseMap=t=>new Map(t.map(t=>[t.toLowerCase(),t]));export const loadDocsConfig=()=>{let t=e(f,"utf-8"),r=parseTopCategoriesFromPreview(t),s=buildCategoryCaseMap(r);return{topCategories:r,caseMap:s}};export const discoverMdxFiles=async()=>i([`${o(STORYBOOK_SRC)}/**/*.mdx`,`${o(UI_SDK_SRC)}/**/*.mdx`],{absolute:!0});export const getSource=t=>t.startsWith(STORYBOOK_EXAMPLES)?"storybook-example":t.startsWith(STORYBOOK_SRC)?"storybook-root":t.startsWith(UI_SDK_SRC)?"ui-sdk":"unknown";let g=/<Meta\s+title=["']([^"']+)["']\s*\/?>/,x=/<Meta\s+of=\{(\w+)\}\s*\/?>/,h=/title:\s*['"]([^'"]+)['"]/;export const parseMdxTitle=t=>{let e=g.exec(t);return e?.[1]};export const parseStoriesTitle=t=>{let e=h.exec(t);return e?.[1]};export const resolveStoriesPath=(e,r)=>{let s=x.exec(r);if(!s)return;let o=s[1],i=r.match(RegExp(`import\\s+\\*\\s+as\\s+${o}\\s+from\\s+['"]([^'"]+)['"]`));if(!i?.[1])return;let a=l(n(e),i[1]);if(!a.endsWith(".tsx")&&!a.endsWith(".ts"))if(t(a+".tsx"))a+=".tsx";else{if(!t(a+".ts"))return;a+=".ts"}return t(a)?a:void 0};export const resolveTitle=(t,r)=>{let s=parseMdxTitle(r);if(s)return s;let o=resolveStoriesPath(t,r);if(!o)return;let i=e(o,"utf-8");return parseStoriesTitle(i)};export const findFirstParagraph=t=>{let e=t.split("\n"),r=[],s=!1,o=!1;for(let t of e){let e=t.trim();if(e.startsWith("```")){o=!o;continue}if(!(o||e.startsWith("- [")||e.startsWith("* [")||e.startsWith("#")||e.startsWith("<")||e.startsWith("{/*")||e.startsWith("|"))&&!e.startsWith(">")){if(""===e){if(s&&r.length>0)break;continue}s=!0,r.push(e)}}return r.length>0?r.join(" "):void 0};export const truncateAtWord=(t,e)=>{if(t.length<=e)return t;let r=t.slice(0,e),s=r.lastIndexOf(" ");return(s>0?r.slice(0,s):r)+"..."};export const extractDescription=t=>{let e=t.split("\n").filter(t=>!t.startsWith("import ")).filter(t=>!t.startsWith("<Meta")).filter(t=>!t.startsWith("<Canvas")).filter(t=>!t.startsWith("<Story")).filter(t=>!t.startsWith("<Controls")).filter(t=>!t.startsWith("<Markdown")).join("\n"),r=/^# .+$/m.exec(e),s=/^## .+$/m.exec(e),o=r?r.index+r[0].length:0,i=s?s.index:e.length,n=e.slice(o,i),a=findFirstParagraph(n);if(!a&&s){let t=e.slice(s.index+s[0].length),r=/^## .+$/m.exec(t),o=r?t.slice(0,r.index):t;a=findFirstParagraph(o)}return a?truncateAtWord(a,200):""};export const parseCategoryPath=t=>{let e=t.split(/\s*\/\s*/).map(t=>t.trim()).filter(Boolean);return 0===e.length?["Uncategorized"]:e};export const normalizeTopCategory=(t,e)=>e.get(t.toLowerCase())??t;export const slugify=t=>t.toLowerCase().replace(/&/g,"and").replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"");export const computeOutputPath=(t,e)=>{let r=t.slice(0,-1).map(slugify).join("/"),s=`${e}.mdx`;return r?`${r}/${s}`:s};export const resolveDocMeta=(t,e)=>{let r=parseCategoryPath(t),s=r[0],o=r[r.length-1];if(!s||!o)return;let i=[normalizeTopCategory(s,e),...r.slice(1)],n=slugify(o),a=computeOutputPath(i,n);return{title:t,lastSegment:o,normalizedSegments:i,docSlug:n,outputRelative:a}};let d=[/^import\s+\{[^}]*\}\s+from\s+['"]@storybook\/[^'"]+['"]\s*$/gm,/^import\s+\*\s+as\s+\w+\s+from\s+['"][^'"]*\.stories[^'"]*['"]\s*$/gm,/^import\s+\w+\s+from\s+['"][^'"]*\.stories[^'"]*['"]\s*$/gm,/^import\s+\w+\s+from\s+['"][^'"]*\.mdx[^'"]*['"]\s*$/gm,/^import\s+\w+\s+from\s+['"][^'"]*\?raw['"]\s*$/gm,/^<Meta\s+[^>]*\/>\s*$/gm,/^<Canvas\s+[^>]*\/>\s*$/gm,/^<Story\s+[^>]*\/>\s*$/gm,/^<Controls\s+[^>]*\/>\s*$/gm,/^<Markdown>\{[^}]+\}<\/Markdown>\s*$/gm],O=/^import\s+(?:type\s+)?\{\s*phx\s*\}\s+from\s+['"](?:\.\.\/)+\.phoenix\/phx\.js['"];?\s*$/;export const stripStorybookImports=t=>{let e=(t=>{let e=t.split("\n"),r=[];for(let[t,s]of e.entries()){if(O.test(s))continue;let o=e[t-1],i=(r.at(-1)??"").startsWith("```");""===s.trim()&&void 0!==o&&O.test(o)&&i||r.push(s)}return r.join("\n")})(t);for(let t of d)e=e.replace(t,"");return e.replace(/\n{3,}/g,"\n\n").trim()+"\n"};export const buildCategoryTree=(t,e,r)=>{let s=new Map,o=(t,e)=>{let r=t.get(e);return r||(r={name:e,docs:[],subcategories:new Map},t.set(e,r)),r};for(let e of t){let t=e.category,i=t[0];if(0===t.length||!i)continue;let n=o(s,normalizeTopCategory(i,r));if(1===t.length){n.docs.push(e);continue}let a=n;for(let e=1;e<t.length-1;e++){let r=t[e];r&&(a=o(a.subcategories,r))}a.docs.push(e)}let i=new Map(e.map((t,e)=>[t,e])),n=t=>({name:t.name,docs:t.docs,subcategories:Array.from(t.subcategories.values()).map(n)});return Array.from(s.values()).sort((t,e)=>(i.get(t.name)??999)-(i.get(e.name)??999)||t.name.localeCompare(e.name)).map(n)};export const getDirectorySizeBytes=t=>{let e=0;for(let o of r(t,{withFileTypes:!0})){let r=a(t,o.name);o.isDirectory()?e+=getDirectorySizeBytes(r):e+=s(r).size}return e};export const formatBytes=t=>{if(t<1024)return`${t} B`;let e=t/1024;if(e<1024)return`${e.toFixed(1)} KB`;let r=e/1024;return`${r.toFixed(1)} MB`};

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

@@ -1,23 +1,31 @@
 import { type ViteDevServer } from 'vite';
+import type { PageExperience } from '#package/application-spec';
 import type { Logger } from '../utils/index.js';
+import type { DeploymentPreparationService } from './deployment/index.js';
+import type { LinguiWatcher } from './lingui-watcher.js';
 import type { PhoenixPubSub } from './phoenix-pubsub.js';
+import type { PhoenixStore } from './phoenix-store.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 pubsub: PhoenixPubSub;
     readonly logger: Logger;
-    readonly onRebuilt?: () => void;
-    readonly onViteServerChange?: (viteServer: ViteDevServer) => void;
     readonly sdkVersion: string;
     readonly projectSlug: string;
     readonly environmentSlug: string;
     readonly cliUseWorkspace?: boolean;
-    readonly name?: string;
-    readonly description?: string;
-    readonly enableEditor: boolean;
+    readonly pageExperience: PageExperience;
     readonly inlineTemplates: boolean;
     readonly useServer: boolean;
 }
+/** Services the watcher notifies after a rebuild; the store owns its replaceable Vite handle. */
+export interface ApplicationSpecProjectWatcherContext {
+    readonly store: PhoenixStore;
+    readonly linguiWatcher: LinguiWatcher | undefined;
+    readonly deploymentPreparation: DeploymentPreparationService | undefined;
+}
 /**
  * Application-spec project watcher with layered caching via {@link ApplicationSpecBuilder}:
  *
@@ -29,22 +37,21 @@ export interface ApplicationSpecProjectWatcherConfig {
  * Rebuilds are serialized via PromiseQueue(1).
  */
 export declare class ApplicationSpecProjectWatcher {
+    private readonly context;
     private watcher;
     private subscription;
     private readonly rebuildQueue;
     /** Each watcher event emits the changed source path; debounced + buffered into batches. */
     private readonly changeSubject$;
-    private viteServer;
     private readonly pubsub;
     private readonly logger;
-    private readonly onRebuilt?;
-    private readonly onViteServerChange?;
     private readonly builder;
     private readonly useServer;
+    private readonly agentMode;
     private isShuttingDown;
     private suspended;
     private readonly heldChanges;
-    constructor(config: ApplicationSpecProjectWatcherConfig);
+    constructor(config: ApplicationSpecProjectWatcherConfig, context: ApplicationSpecProjectWatcherContext);
     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;

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 h}from"../application-spec/application-spec-builder.js";import{logDiagnostics as a}from"../application-spec/metrics/index.js";import{syncTemplateFiles as c}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"],d=["src/locales/**/*.{ts,tsx}",".phoenix/**"];export class ApplicationSpecProjectWatcher{watcher=null;subscription=null;rebuildQueue=new t(1,1/0);changeSubject$=new i;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(){this.watcher=l(g,{ignored:d,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(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 a}from"vite";import{watch as c}from"#package/watch";import{ApplicationSpecBuilder as l}from"../application-spec/application-spec-builder.js";import{logDiagnostics as h}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=["package.json","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{context;watcher=null;subscription=null;rebuildQueue=new i(1,1/0);changeSubject$=new s;pubsub;logger;builder;useServer;agentMode;isShuttingDown=!1;suspended=!1;heldChanges=new Set;constructor(e,t){this.context=t,this.pubsub=e.pubsub,this.logger=e.logger,this.builder=new l({logger:e.logger,sdkVersion:e.sdkVersion,projectSlug:e.projectSlug,environmentSlug:e.environmentSlug,cliUseWorkspace:e.cliUseWorkspace,pageExperience:e.pageExperience,inlineTemplates:e.inlineTemplates}),this.useServer=e.useServer,this.agentMode="agent"===e.pageExperience}start(e){this.context.store.viteServer$.next(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=c(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,!1))})})}async rebuild(t,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 l=await c();if(this.isShuttingDown)return;let h=await this.builder.build({compile:!s});if(this.isShuttingDown)return;if(a(h.diagnostics,this.logger),!h.ok){for(let e of h.errors)this.logger.error(`[${e.code}] ${e.message}${e.file?` (${e.file})`:""}`);this.pubsub.specFile$.next({rawProjectFiles:h.rawProjectFiles,projectRoot:process.cwd()});return}this.onRebuilt?.();let{application:g,changedFiles:d}=h,w=r.moduleGraph,b=Date.now(),f=new Set,m=process.cwd(),S=e=>{let t=w.getModulesByFile(n(e));if(t)for(let e of t)w.invalidateModule(e,f,b,!0)};for(let i of t)S(e(m,i));for(let t of d)S(e(m,`.phoenix/${t.path}`));if(this.pubsub.specFile$.next({rawProjectFiles:g.rawProjectFiles,projectRoot:process.cwd(),configurationSchemaHash:g.applicationSpec.configurator.configurationSchema.hash}),this.isShuttingDown)return;if(i){if(await r.close(),this.isShuttingDown)return;let e=await p({templateFiles:l});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&&!s){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.context.store.viteServer$.value;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 c=await this.builder.build({compile:!s});if(this.isShuttingDown)return;if(h(c.diagnostics,this.logger),!c.ok){for(let e of c.errors)this.logger.error(`[${e.code}] ${e.message}${e.file?` (${e.file})`:""}`);this.pubsub.specFile$.next({rawProjectFiles:c.rawProjectFiles,projectRoot:process.cwd(),build:"failed"});return}let{application:l,changedFiles:d}=c;this.context.linguiWatcher?.trigger(),this.context.deploymentPreparation?.reportUnregisteredSpec(l.applicationSpec);let w=r.moduleGraph,f=Date.now(),b=new Set,m=process.cwd(),S=e=>{let t=w.getModulesByFile(a(e));if(t)for(let e of t)w.invalidateModule(e,b,f,!0)};for(let i of e)S(t(m,i));for(let e of d)S(t(m,`.phoenix/${e.path}`));if(this.pubsub.specFile$.next({rawProjectFiles:l.rawProjectFiles,projectRoot:process.cwd(),configurationSchemaHash:l.applicationSpec.configurator.configurationSchema.hash,build:"ok"}),this.isShuttingDown)return;if(i){if(await r.close(),this.isShuttingDown)return;let e=await g({templateFiles:o,agentMode:this.agentMode});if(this.isShuttingDown)return;let t=await n(e);if(this.isShuttingDown||(await t.listen(),this.isShuttingDown))return void await t.close();this.context.store.viteServer$.next(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)}}}

package/dist/phoenix/services/cli-credentials.d.ts

@@ -5,22 +5,25 @@ import { z } from 'zod';
 declare const ServerCredentials: z.ZodObject<{
     token: z.ZodString;
     userId: z.ZodString;
-    customerSlug: z.ZodString;
-    customerName: z.ZodString;
+    customerId: z.ZodOptional<z.ZodString>;
+    customerSlug: z.ZodOptional<z.ZodString>;
+    customerName: z.ZodOptional<z.ZodString>;
     studioUrl: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     token: string;
     userId: string;
-    customerSlug: string;
-    customerName: string;
+    customerId?: string | undefined;
+    customerSlug?: string | undefined;
+    customerName?: string | undefined;
     studioUrl?: string | undefined;
     createdAt: string;
 }, {
     token: string;
     userId: string;
-    customerSlug: string;
-    customerName: string;
+    customerId?: string | undefined;
+    customerSlug?: string | undefined;
+    customerName?: string | undefined;
     studioUrl?: string | undefined;
     createdAt: string;
 }>;

package/dist/phoenix/services/cli-credentials.js

@@ -1,2 +1,2 @@
-import{chmod as e,mkdir as r,readFile as t,writeFile as s}from"node:fs/promises";import{homedir as n}from"node:os";import{dirname as a,join as i}from"node:path";import{z as o}from"zod";let l=o.object({token:o.string().min(1),userId:o.string(),customerSlug:o.string(),customerName:o.string(),studioUrl:o.string().optional(),createdAt:o.string()}),c=o.object({version:o.literal(1),servers:o.record(o.string(),l)}),d={version:1,servers:{}};export const getCredentialsPath=()=>process.env.PHOENIX_CREDENTIALS_FILE??i(n(),".phoenix","credentials.json");let u=e=>new URL(e).origin,g=async()=>{let e;try{e=await t(getCredentialsPath(),"utf8")}catch(e){if(e instanceof Error&&"code"in e&&"ENOENT"===e.code)return d;throw e}let r=c.safeParse((e=>{try{return JSON.parse(e)}catch{return null}})(e));if(!r.success)throw Error(`The credentials file ${getCredentialsPath()} is not valid. Delete it and run \`phoenix login\` again.`);return r.data},m=async t=>{let n=getCredentialsPath();return await r(a(n),{recursive:!0,mode:448}),await s(n,`${JSON.stringify(t,null,2)}
-`,{mode:384}),await e(n,384),n};export const getServerCredentials=async e=>(await g()).servers[u(e)]??null;export const saveServerCredentials=async(e,r)=>{let t=await g();return m({...t,servers:{...t.servers,[u(e)]:r}})};export const removeServerCredentials=async e=>{let r=await g(),{[u(e)]:t,...s}=r.servers;await m({...r,servers:s})};
+import{chmod as e,mkdir as r,readFile as t,writeFile as s}from"node:fs/promises";import{homedir as n}from"node:os";import{dirname as o,join as i}from"node:path";import{z as a}from"zod";let l=a.object({token:a.string().min(1),userId:a.string(),customerId:a.string().uuid().optional(),customerSlug:a.string().optional(),customerName:a.string().optional(),studioUrl:a.string().optional(),createdAt:a.string()}),c=a.object({version:a.literal(1),servers:a.record(a.string(),l)}),d={version:1,servers:{}};export const getCredentialsPath=()=>process.env.PHOENIX_CREDENTIALS_FILE??i(n(),".phoenix","credentials.json");let u=e=>new URL(e).origin,g=async()=>{let e;try{e=await t(getCredentialsPath(),"utf8")}catch(e){if(e instanceof Error&&"code"in e&&"ENOENT"===e.code)return d;throw e}let r=c.safeParse((e=>{try{return JSON.parse(e)}catch{return null}})(e));if(!r.success)throw Error(`The credentials file ${getCredentialsPath()} is not valid. Delete it and run \`phoenix login\` again.`);return r.data},p=async t=>{let n=getCredentialsPath();return await r(o(n),{recursive:!0,mode:448}),await s(n,`${JSON.stringify(t,null,2)}
+`,{mode:384}),await e(n,384),n};export const getServerCredentials=async e=>(await g()).servers[u(e)]??null;export const saveServerCredentials=async(e,r)=>{let t=await g();return p({...t,servers:{...t.servers,[u(e)]:r}})};export const removeServerCredentials=async e=>{let r=await g(),{[u(e)]:t,...s}=r.servers;await p({...r,servers:s})};

package/dist/phoenix/services/cli-exit.d.ts

@@ -0,0 +1,5 @@
+type BeforeCliExit = (exitCode: number) => Promise<void>;
+export declare const setBeforeCliExit: (handler: BeforeCliExit) => (() => void);
+/** Gives the Phoenix CLI a chance to finish best-effort work, then preserves process.exit semantics. */
+export declare const exitCli: (exitCode: number) => Promise<never>;
+export {};

package/dist/phoenix/services/cli-exit.js

@@ -0,0 +1 @@
+let t=null;export const setBeforeCliExit=e=>(t=e,()=>{t===e&&(t=null)});export const exitCli=async e=>{try{await t?.(e)}finally{process.exit(e)}};

package/dist/phoenix/services/deployment/deployment-preparation-service.d.ts

@@ -0,0 +1,28 @@
+import type { ApplicationSpec } from '#package/application-spec';
+import type { Logger } from '../../utils/index.js';
+import type { DevelopmentCredential } from '../development-credential.js';
+import type { PhoenixStore } from '../phoenix-store.js';
+/** The deployment identity a server-backed dev session prepares and checks after rebuilds. */
+export interface DeploymentPreparationServiceProps {
+    readonly serverUrl: string;
+    readonly credential: DevelopmentCredential;
+    readonly projectSlug: string;
+    readonly environmentSlug: string;
+    readonly sdkVersion: string;
+}
+export interface DeploymentPreparationServiceContext {
+    readonly logger: Logger;
+    readonly store: PhoenixStore;
+}
+/** Prepares the active dev deployment and reports spec changes that require a session restart. */
+export declare class DeploymentPreparationService {
+    private readonly props;
+    private readonly context;
+    constructor(props: DeploymentPreparationServiceProps, context: DeploymentPreparationServiceContext);
+    prepare(): Promise<void>;
+    prepareAtStartup(options: {
+        readonly skipUpload: boolean;
+        readonly debug: boolean;
+    }): Promise<void>;
+    reportUnregisteredSpec(applicationSpec: ApplicationSpec): Promise<void>;
+}

package/dist/phoenix/services/deployment/deployment-preparation-service.js

@@ -0,0 +1 @@
+import{mkdir as e}from"node:fs/promises";import{dirname as t}from"node:path";import{resolveGeneratedEnvFile as r}from"@salsita-ai/common/env";import{getDeploymentFingerprint as o}from"../../application-spec/index.js";import{prepareDevelopmentEnvironment as n}from"../prepare-development-environment.js";import{readGeneratedEnvMarkers as i}from"./generated-env-markers.js";export class DeploymentPreparationService{props;context;constructor(e,t){this.props=e,this.context=t}prepare(){return this.prepareAtStartup({skipUpload:!0,debug:!1})}async prepareAtStartup(o){let i=r(".");await e(t(i),{recursive:!0}),await n({serverUrl:this.props.serverUrl,projectSlug:this.props.projectSlug,environmentSlug:this.props.environmentSlug,credential:this.props.credential,outFile:i,skipUpload:o.skipUpload,overrideSchema:!0,debug:o.debug,projectVersion:this.props.sdkVersion},{logger:this.context.logger})}async reportUnregisteredSpec(e){try{let t=o(e),n=await i(r("."));if(!n||n.PHOENIX_DEPLOYMENT_FINGERPRINT===t)return void this.context.store.reportedFingerprint$.next(null);if(this.context.store.reportedFingerprint$.value===t)return;this.context.store.reportedFingerprint$.next(t),this.context.logger.error("The development deployment on the server still has the domain model and deployment settings it was prepared with, not the ones the spec now declares: a running phoenix dev cannot register a change, because its webhook tunnel and the preview stay bound to the deployment they started with. Restart phoenix dev to prepare the deployment again, then open the Preview address it prints rather than reloading a tab whose address has ?cid=, which loads a configuration saved with the earlier model.")}catch(e){this.context.logger.warn(`Could not compare the spec with the development deployment: ${e instanceof Error?e.message:String(e)}. After a domain model change, restart phoenix dev to register it.`)}}}

package/dist/phoenix/services/deployment/generated-env-markers.d.ts

@@ -0,0 +1,8 @@
+export interface GeneratedEnvMarkers {
+    readonly DEPLOYMENT_ID?: string;
+    readonly PHOENIX_PROJECT_SLUG?: string;
+    readonly PHOENIX_ENVIRONMENT_SLUG?: string;
+    readonly PHOENIX_SERVER_URL?: string;
+    readonly PHOENIX_DEPLOYMENT_FINGERPRINT?: string;
+}
+export declare const readGeneratedEnvMarkers: (outFile: string) => Promise<GeneratedEnvMarkers | null>;

package/dist/phoenix/services/deployment/generated-env-markers.js

@@ -0,0 +1 @@
+import{parse as E}from"dotenv";import{readFile as N}from"node:fs/promises";export const readGeneratedEnvMarkers=async r=>{try{let _=E(await N(r));return{DEPLOYMENT_ID:_.DEPLOYMENT_ID,PHOENIX_PROJECT_SLUG:_.PHOENIX_PROJECT_SLUG,PHOENIX_ENVIRONMENT_SLUG:_.PHOENIX_ENVIRONMENT_SLUG,PHOENIX_SERVER_URL:_.PHOENIX_SERVER_URL,PHOENIX_DEPLOYMENT_FINGERPRINT:_.PHOENIX_DEPLOYMENT_FINGERPRINT}}catch(E){if(E instanceof Error&&"code"in E&&"ENOENT"===E.code)return null;throw E}};

package/dist/phoenix/services/deployment/index.d.ts

@@ -0,0 +1,2 @@
+export { readGeneratedEnvMarkers } from './generated-env-markers.js';
+export { DeploymentPreparationService } from './deployment-preparation-service.js';