@salsita-ai/sdk 0.50.0-develop.0b28d3ba99 → 0.50.0-develop.0d2418cc3b

package/dist/phoenix/commands/dev.js

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

package/dist/phoenix/commands/docs.js

@@ -1 +1 @@
-import{readFileSync as e}from"fs";import{dirname as t,join as o}from"path";import{fileURLToPath as r}from"url";import{truncateAtWord as n}from"../scripts/docs-utils.js";let s=o(t(r(import.meta.url)),"../.."),a=o(s,"docs/index.json");export const flattenDocs=e=>{let t=[],o=e=>{for(let r of e)t.push(...r.docs),o(r.subcategories)};return o(e),t};export const findCategory=(e,t)=>{let o=t.toLowerCase(),r=e=>{for(let t of e){if(t.name.toLowerCase()===o)return t;let e=r(t.subcategories);if(e)return e}};return r(e)};let c=e=>{let t=e.docs.length;for(let o of e.subcategories)t+=c(o);return t};export const formatIndex=e=>{let t=flattenDocs(e.categories).length,o=[`Phoenix SDK Documentation (${t} docs)`,"","Browse SDK docs for guides on domain model, components, layouts, 3D scene,","webhooks, and more. Use flags below to search, read, or browse by category.","","Categories:"];for(let t of e.categories){let e=c(t),r=t.subcategories.length>0?` (${t.subcategories.map(e=>e.name).join(", ")})`:"";o.push(`  ${t.name} — ${e} docs${r}`)}return o.push("","Usage:","  pnpm phoenix docs -s 'snackbar'         Search all doc content","  pnpm phoenix docs --dir                  Print docs directory for grep","  pnpm phoenix docs -l                     List all doc paths",'  pnpm phoenix docs -l | grep "camera"     Search doc titles',"  pnpm phoenix docs -r <path>              Read a doc (raw MDX to stdout)",'  pnpm phoenix docs -r <path> | grep "ex"  Search within a doc',"  pnpm phoenix docs -c Phoenix             Browse docs in a category"),o.join("\n")};export const formatDocPaths=e=>flattenDocs(e.categories).map(e=>`${e.path}	${e.title}`).join("\n");export const searchDocs=(e,t,o)=>{let r=o.toLowerCase();return flattenDocs(e.categories).map(e=>{let n=t(e.path).split("\n").flatMap((e,t)=>{let n=e.toLowerCase().indexOf(r);return n>=0?[{line:t+1,text:e,matchIndex:n,matchLength:o.length}]:[]}),s=[e.title,e.description,...e.category].some(e=>e.toLowerCase().includes(r));return{entry:e,matches:n,matchCount:n.length+Number(s),metadataMatch:s}}).filter(e=>e.matchCount>0).sort((e,t)=>t.matchCount-e.matchCount||e.entry.path.localeCompare(t.entry.path))};export const formatSearchResults=(e,t={})=>{let{maxSnippets:o=3,maxLineLength:r=120}=t;return e.map(e=>{let t=[`${e.entry.path}	${e.entry.title}`],s=e.matches.slice(0,o);for(let e of s){let o=e.text.trim(),s=e.text.length-e.text.trimStart().length,a=Math.max(0,e.matchIndex-s),c=n(o,r),i=o.slice(a,a+e.matchLength);if(c.toLowerCase().includes(i.toLowerCase())){t.push(`  L${e.line}: ${c}`);continue}let l=Math.max(1,r-6),h=Math.min(e.matchLength,l),p=Math.min(Math.max(0,a-Math.floor((l-h)/2)),Math.max(0,o.length-l)),m=Math.min(o.length,p+l),d=p>0?"...":"",f=m<o.length?"...":"";t.push(`  L${e.line}: ${d}${o.slice(p,m)}${f}`)}let a=e.matches.length-s.length;return a>0&&t.push(`  (+${a} more)`),t.join("\n")}).join("\n\n")};export const formatCategory=e=>{let t=c(e),o=[`${e.name} (${t} docs)`,""],r=(e,t)=>{let s="  ".repeat(t);for(let t of e.docs){let e=t.description?` — ${n(t.description,60)}`:"";o.push(`${s}${t.title}${e}`),o.push(`${s}  ${t.path}`)}for(let n of e.subcategories){let e=c(n);o.push(`${s}${n.name} (${e} docs)`),r(n,t+1)}};return r(e,1),o.join("\n")};export const runDocsCommand=async(t,r)=>{let{logger:n}=r;try{if(t.dir)return void console.log(o(s,"docs"));let r=e(a,"utf-8"),c=JSON.parse(r);if(t.list)return void console.log(formatDocPaths(c));if(t.search){let r=searchDocs(c,t=>e(o(s,t),"utf-8"),t.search);0===r.length&&(n.error(`No docs match "${t.search}"`),process.exit(1)),console.log(formatSearchResults(r));return}if(t.read){let r=o(s,t.read),n=e(r,"utf-8");console.log(n);return}if(t.category){let e=findCategory(c.categories,t.category);if(!e){n.error(`Category "${t.category}" not found`);let e=c.categories.map(e=>e.name);n.info(`Available categories: ${e.join(", ")}`),process.exit(1)}console.log(formatCategory(e));return}console.log(formatIndex(c))}catch(e){throw e instanceof Error&&"code"in e&&"ENOENT"===e.code&&(n.error("Docs index not found. Run docs generation first (pnpm run generate:docs-index)"),process.exit(1)),e}};
+import{readFileSync as e}from"fs";import{dirname as t,join as o}from"path";import{fileURLToPath as r}from"url";import{truncateAtWord as n}from"../scripts/docs-utils.js";import{exitCli as a}from"../services/index.js";let s=o(t(r(import.meta.url)),"../.."),c=o(s,"docs/index.json");export const flattenDocs=e=>{let t=[],o=e=>{for(let r of e)t.push(...r.docs),o(r.subcategories)};return o(e),t};export const findCategory=(e,t)=>{let o=t.toLowerCase(),r=e=>{for(let t of e){if(t.name.toLowerCase()===o)return t;let e=r(t.subcategories);if(e)return e}};return r(e)};let i=e=>{let t=e.docs.length;for(let o of e.subcategories)t+=i(o);return t};export const formatIndex=e=>{let t=flattenDocs(e.categories).length,o=[`Phoenix SDK Documentation (${t} docs)`,"","Browse SDK docs for guides on domain model, components, layouts, 3D scene,","webhooks, and more. Use flags below to search, read, or browse by category.","","Categories:"];for(let t of e.categories){let e=i(t),r=t.subcategories.length>0?` (${t.subcategories.map(e=>e.name).join(", ")})`:"";o.push(`  ${t.name} — ${e} docs${r}`)}return o.push("","Usage:","  pnpm phoenix docs -s 'snackbar'         Search all doc content","  pnpm phoenix docs --dir                  Print docs directory for grep","  pnpm phoenix docs -l                     List all doc paths",'  pnpm phoenix docs -l | grep "camera"     Search doc titles',"  pnpm phoenix docs -r <path>              Read a doc (raw MDX to stdout)",'  pnpm phoenix docs -r <path> | grep "ex"  Search within a doc',"  pnpm phoenix docs -c Phoenix             Browse docs in a category"),o.join("\n")};export const formatDocPaths=e=>flattenDocs(e.categories).map(e=>`${e.path}	${e.title}`).join("\n");export const searchDocs=(e,t,o)=>{let r=o.toLowerCase();return flattenDocs(e.categories).map(e=>{let n=t(e.path).split("\n").flatMap((e,t)=>{let n=e.toLowerCase().indexOf(r);return n>=0?[{line:t+1,text:e,matchIndex:n,matchLength:o.length}]:[]}),a=[e.title,e.description,...e.category].some(e=>e.toLowerCase().includes(r));return{entry:e,matches:n,matchCount:n.length+Number(a),metadataMatch:a}}).filter(e=>e.matchCount>0).sort((e,t)=>t.matchCount-e.matchCount||e.entry.path.localeCompare(t.entry.path))};export const formatSearchResults=(e,t={})=>{let{maxSnippets:o=3,maxLineLength:r=120}=t;return e.map(e=>{let t=[`${e.entry.path}	${e.entry.title}`],a=e.matches.slice(0,o);for(let e of a){let o=e.text.trim(),a=e.text.length-e.text.trimStart().length,s=Math.max(0,e.matchIndex-a),c=n(o,r),i=o.slice(s,s+e.matchLength);if(c.toLowerCase().includes(i.toLowerCase())){t.push(`  L${e.line}: ${c}`);continue}let l=Math.max(1,r-6),h=Math.min(e.matchLength,l),p=Math.min(Math.max(0,s-Math.floor((l-h)/2)),Math.max(0,o.length-l)),m=Math.min(o.length,p+l),d=p>0?"...":"",f=m<o.length?"...":"";t.push(`  L${e.line}: ${d}${o.slice(p,m)}${f}`)}let s=e.matches.length-a.length;return s>0&&t.push(`  (+${s} more)`),t.join("\n")}).join("\n\n")};export const formatCategory=e=>{let t=i(e),o=[`${e.name} (${t} docs)`,""],r=(e,t)=>{let a="  ".repeat(t);for(let t of e.docs){let e=t.description?` — ${n(t.description,60)}`:"";o.push(`${a}${t.title}${e}`),o.push(`${a}  ${t.path}`)}for(let n of e.subcategories){let e=i(n);o.push(`${a}${n.name} (${e} docs)`),r(n,t+1)}};return r(e,1),o.join("\n")};export const runDocsCommand=async(t,r)=>{let{logger:n}=r;try{if(t.dir)return void console.log(o(s,"docs"));let r=e(c,"utf-8"),i=JSON.parse(r);if(t.list)return void console.log(formatDocPaths(i));if(t.search){let r=searchDocs(i,t=>e(o(s,t),"utf-8"),t.search);if(0===r.length){n.error(`No docs match "${t.search}"`),await a(1);return}console.log(formatSearchResults(r));return}if(t.read){let r=o(s,t.read),n=e(r,"utf-8");console.log(n);return}if(t.category){let e=findCategory(i.categories,t.category);if(!e){n.error(`Category "${t.category}" not found`);let e=i.categories.map(e=>e.name);n.info(`Available categories: ${e.join(", ")}`),await a(1);return}console.log(formatCategory(e));return}console.log(formatIndex(i))}catch(e){if(e instanceof Error&&"code"in e&&"ENOENT"===e.code){n.error("Docs index not found. Run docs generation first (pnpm run generate:docs-index)"),await a(1);return}throw e}};

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

@@ -1 +1 @@
-import{createApiBaseClient as e}from"#package/client";import{readUploadLinks as t,uploadFilesWithPresignedUrls as i}from"../utils/index.js";export const runFinishDeploymentCommand=async(o,s)=>{let{logger:a}=s;try{a.step("Finishing deployment");let{uuid:s,uploadLinksFile:n,apiKey:l,projectKey:r,projectSlug:p,lambdaUrl:d,serverUrl:c,skipUpload:m}=o;if(a.debug(`Using deployment ID: ${s}`),a.debug(`Upload links file: ${n}, project: ${p}, lambda: ${d}`),m)a.info("Skipping upload (skipUpload flag set)");else{let e=await t(n,{logger:a});a.info("Uploading files to S3..."),await i(e,{logger:a})}a.info("Activating deployment..."),a.debug(`Creating API client for server: ${c}`);let f=e(c),{error:y}=await f.POST("/deployments/{deploymentId}/activate",{params:{path:{deploymentId:s}},headers:{"x-api-key":l,"x-project-key":r,"x-project-slug":p},body:{lambdaUrl:d}});if(y)throw Error(`Failed to activate deployment with server: ${y.message}`);a.info("Deployment activated successfully"),a.success("Deployment finished successfully!")}catch(e){a.error(`Deployment finish failed: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};
+import{createApiBaseClient as e}from"#package/client";import{exitCli as t}from"../services/index.js";import{readUploadLinks as i,uploadFilesWithPresignedUrls as o}from"../utils/index.js";export const runFinishDeploymentCommand=async(a,s)=>{let{logger:n}=s;try{n.step("Finishing deployment");let{uuid:t,uploadLinksFile:s,apiKey:l,projectKey:r,projectSlug:p,lambdaUrl:d,serverUrl:m,skipUpload:c}=a;if(n.debug(`Using deployment ID: ${t}`),n.debug(`Upload links file: ${s}, project: ${p}, lambda: ${d}`),c)n.info("Skipping upload (skipUpload flag set)");else{let e=await i(s,{logger:n});n.info("Uploading files to S3..."),await o(e,{logger:n})}n.info("Activating deployment..."),n.debug(`Creating API client for server: ${m}`);let f=e(m),{error:y}=await f.POST("/deployments/{deploymentId}/activate",{params:{path:{deploymentId:t}},headers:{"x-api-key":l,"x-project-key":r,"x-project-slug":p},body:{lambdaUrl:d}});if(y)throw Error(`Failed to activate deployment with server: ${y.message}`);n.info("Deployment activated successfully"),n.success("Deployment finished successfully!")}catch(e){n.error(`Deployment finish failed: ${e instanceof Error?e.message:String(e)}`,e),await t(1)}};

package/dist/phoenix/commands/fix.js

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

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

@@ -12,7 +12,7 @@ export { prepareDevelopmentEnvironment } from '../services/prepare-development-e
 export { prepareLocalEnvironment } from './prepare-local-environment-command.js';
 export { runFinishDeploymentCommand } from './finish-deployment-command.js';
 export { runDeploymentBuildEnvsCommand } from './deployment-build-envs-command.js';
-export { runDepsCommand } from './deps/index.js';
+export { findSdkPeerMismatches, runDepsCommand } from './deps/index.js';
 export { runDevCommand } from './dev.js';
 export { runFixCommand } from './fix.js';
 export { runLinkCommand } from './link.js';

package/dist/phoenix/commands/index.js

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

package/dist/phoenix/commands/inspect-assets.js

@@ -1 +1 @@
-import{globby as e}from"globby";import{resolve as o}from"path";import{inspectGltfFile as t}from"./gltf-inspector.js";let n=e=>e<1024?`${e} B`:e<1048576?`${(e/1024).toFixed(1)} KB`:`${(e/1048576).toFixed(1)} MB`;export const formatSummary=e=>{let o=[`File: ${e.filePath}`,`Size: ${n(e.fileSize)}${e.fileSize>0xa00000?" (large file)":""}`,`Format: ${e.format} ${e.version}`,`Generator: ${e.generator}`];return e.extensions.length>0&&o.push(`Extensions: ${e.extensions.join(", ")}`),e.dracoCompressed&&o.push("Note: Draco-compressed meshes (vertex data not decoded)"),o.join("\n")};let r=e=>String(Math.round(1e3*e)/1e3),a=e=>`[${e.map(r).join(", ")}]`,i=(e,o)=>0===o||Math.abs(e)<.01*o,s=(e,o)=>o>0&&Math.abs(Math.abs(e)-o/2)<.01*o,l=e=>{let o,t,n,l=e.children.length>0?` [${e.children.join(", ")}]`:"",m=`  ${e.name} (${e.type})${l}`;if((0!==(o=e.translation)[0]||0!==o[1]||0!==o[2])&&(m+=`  pos=${a(e.translation)}`),(0!==(t=e.rotation)[0]||0!==t[1]||0!==t[2]||1!==t[3])&&(m+=`  rot=${a(e.rotation)}`),(1!==(n=e.scale)[0]||1!==n[1]||1!==n[2])&&(m+=`  scale=${a(e.scale)}`),e.morphTargets.length>0&&(m+=`  morphs=${e.morphTargets.join(",")}`),e.boundingBox){let o=e.boundingBox.dimensions,t=e.boundingBox.originOffset,n=((e,o)=>{let t=i(e[0],o[0]),n=i(e[1],o[1]),r=i(e[2],o[2]);if(t&&n&&r)return"center";let a=s(e[1],o[1])?e[1]>0?"bottom":"top":"",l=s(e[0],o[0]),m=s(e[2],o[2]),f=t&&r?"center":l&&m?"corner":l||m?"edge":"";return a&&f?`${a}-${f}`:a||f||"offset"})(t,o);m+=`  bounds=${r(o[0])}x${r(o[1])}x${r(o[2])}  origin=${n} ${a(t)}`}return m};export const formatNodes=e=>0===e.length?"Nodes: (none)":[`Nodes (${e.length}):`,...e.map(l)].join("\n");export const formatMaterials=e=>0===e.length?"Materials: (none)":[`Materials (${e.length}):`,...e.map(e=>`  ${e.name}`)].join("\n");export const formatMorphTargets=e=>{if(0===e.size)return"Morph Targets: (none)";let o=["Morph Targets:"];for(let[t,n]of e)o.push(`  ${t}: ${n.join(", ")}`);return o.join("\n")};export const formatAnimations=e=>0===e.length?"Animations: (none)":[`Animations (${e.length}):`,...e.map(e=>`  ${e.name} (${e.duration}s, ${e.channelCount} channels)`)].join("\n");export const formatFullReport=e=>[formatSummary(e),"",formatNodes(e.nodes),"",formatMaterials(e.materials),"",formatMorphTargets(e.morphTargets),"",formatAnimations(e.animations)].join("\n");export const formatSummaryTable=e=>{let o="File                                     Size       Nodes  Materials  Morphs  Animations",t="─".repeat(o.length);return[o,t,...e.map(e=>{let o=[...e.morphTargets.values()].reduce((e,o)=>e+o.length,0);return[e.filePath.padEnd(40),n(e.fileSize).padStart(10),String(e.nodes.length).padStart(7),String(e.materials.length).padStart(10),String(o).padStart(8),String(e.animations.length).padStart(11)].join("")})].join("\n")};let m=e=>({...e,morphTargets:Object.fromEntries(e.morphTargets)});export const runInspectAssetsCommand=async(n,r)=>{let{logger:a}=r;try{if(n.file){let e=o(n.file),r=await t(e);if(n.json)return void console.log(JSON.stringify(m(r),null,2));if(n.objects)return void console.log(formatNodes(r.nodes));if(n.materials)return void console.log(formatMaterials(r.materials));if(n.morphs)return void console.log(formatMorphTargets(r.morphTargets));if(n.animations)return void console.log(formatAnimations(r.animations));console.log(formatFullReport(r));return}let r=await e("public/**/*.{glb,gltf}");if(0===r.length)return void a.warn("No glTF/GLB files found in public/");let i=[];for(let e of r)try{i.push(await t(o(e)))}catch(o){a.error(`Failed to parse ${e}`,o)}if(0===i.length)return void a.warn("No files could be parsed");if(n.json)return void console.log(JSON.stringify(i.map(m),null,2));if(n.objects){let e=i.flatMap(e=>e.nodes.map(o=>`${e.filePath}: ${o.name} (${o.type})`));console.log(e.join("\n"));return}if(n.materials){let e=i.flatMap(e=>e.materials.map(o=>`${e.filePath}: ${o.name}`));console.log(e.join("\n"));return}if(n.morphs){let e=[];for(let o of i)for(let[t,n]of o.morphTargets)e.push(`${o.filePath}: ${t} → ${n.join(", ")}`);if(0===e.length)return void a.info("No morph targets found in any file");console.log(e.join("\n"));return}if(n.animations){let e=i.flatMap(e=>e.animations.map(o=>`${e.filePath}: ${o.name} (${o.duration}s, ${o.channelCount} ch)`));if(0===e.length)return void a.info("No animations found in any file");console.log(e.join("\n"));return}console.log(formatSummaryTable(i))}catch(e){e instanceof Error?a.error(e.message):a.error("Unexpected error during asset inspection",e),process.exit(1)}};
+import{globby as e}from"globby";import{resolve as o}from"path";import{exitCli as t}from"../services/index.js";import{inspectGltfFile as n}from"./gltf-inspector.js";let r=e=>e<1024?`${e} B`:e<1048576?`${(e/1024).toFixed(1)} KB`:`${(e/1048576).toFixed(1)} MB`;export const formatSummary=e=>{let o=[`File: ${e.filePath}`,`Size: ${r(e.fileSize)}${e.fileSize>0xa00000?" (large file)":""}`,`Format: ${e.format} ${e.version}`,`Generator: ${e.generator}`];return e.extensions.length>0&&o.push(`Extensions: ${e.extensions.join(", ")}`),e.dracoCompressed&&o.push("Note: Draco-compressed meshes (vertex data not decoded)"),o.join("\n")};let a=e=>String(Math.round(1e3*e)/1e3),i=e=>`[${e.map(a).join(", ")}]`,s=(e,o)=>0===o||Math.abs(e)<.01*o,l=(e,o)=>o>0&&Math.abs(Math.abs(e)-o/2)<.01*o,m=e=>{let o,t,n,r=e.children.length>0?` [${e.children.join(", ")}]`:"",m=`  ${e.name} (${e.type})${r}`;if((0!==(o=e.translation)[0]||0!==o[1]||0!==o[2])&&(m+=`  pos=${i(e.translation)}`),(0!==(t=e.rotation)[0]||0!==t[1]||0!==t[2]||1!==t[3])&&(m+=`  rot=${i(e.rotation)}`),(1!==(n=e.scale)[0]||1!==n[1]||1!==n[2])&&(m+=`  scale=${i(e.scale)}`),e.morphTargets.length>0&&(m+=`  morphs=${e.morphTargets.join(",")}`),e.boundingBox){let o=e.boundingBox.dimensions,t=e.boundingBox.originOffset,n=((e,o)=>{let t=s(e[0],o[0]),n=s(e[1],o[1]),r=s(e[2],o[2]);if(t&&n&&r)return"center";let a=l(e[1],o[1])?e[1]>0?"bottom":"top":"",i=l(e[0],o[0]),m=l(e[2],o[2]),f=t&&r?"center":i&&m?"corner":i||m?"edge":"";return a&&f?`${a}-${f}`:a||f||"offset"})(t,o);m+=`  bounds=${a(o[0])}x${a(o[1])}x${a(o[2])}  origin=${n} ${i(t)}`}return m};export const formatNodes=e=>0===e.length?"Nodes: (none)":[`Nodes (${e.length}):`,...e.map(m)].join("\n");export const formatMaterials=e=>0===e.length?"Materials: (none)":[`Materials (${e.length}):`,...e.map(e=>`  ${e.name}`)].join("\n");export const formatMorphTargets=e=>{if(0===e.size)return"Morph Targets: (none)";let o=["Morph Targets:"];for(let[t,n]of e)o.push(`  ${t}: ${n.join(", ")}`);return o.join("\n")};export const formatAnimations=e=>0===e.length?"Animations: (none)":[`Animations (${e.length}):`,...e.map(e=>`  ${e.name} (${e.duration}s, ${e.channelCount} channels)`)].join("\n");export const formatFullReport=e=>[formatSummary(e),"",formatNodes(e.nodes),"",formatMaterials(e.materials),"",formatMorphTargets(e.morphTargets),"",formatAnimations(e.animations)].join("\n");export const formatSummaryTable=e=>{let o="File                                     Size       Nodes  Materials  Morphs  Animations",t="─".repeat(o.length);return[o,t,...e.map(e=>{let o=[...e.morphTargets.values()].reduce((e,o)=>e+o.length,0);return[e.filePath.padEnd(40),r(e.fileSize).padStart(10),String(e.nodes.length).padStart(7),String(e.materials.length).padStart(10),String(o).padStart(8),String(e.animations.length).padStart(11)].join("")})].join("\n")};let f=e=>({...e,morphTargets:Object.fromEntries(e.morphTargets)});export const runInspectAssetsCommand=async(r,a)=>{let{logger:i}=a;try{if(r.file){let e=o(r.file),t=await n(e);if(r.json)return void console.log(JSON.stringify(f(t),null,2));if(r.objects)return void console.log(formatNodes(t.nodes));if(r.materials)return void console.log(formatMaterials(t.materials));if(r.morphs)return void console.log(formatMorphTargets(t.morphTargets));if(r.animations)return void console.log(formatAnimations(t.animations));console.log(formatFullReport(t));return}let t=await e("public/**/*.{glb,gltf}");if(0===t.length)return void i.warn("No glTF/GLB files found in public/");let a=[];for(let e of t)try{a.push(await n(o(e)))}catch(o){i.error(`Failed to parse ${e}`,o)}if(0===a.length)return void i.warn("No files could be parsed");if(r.json)return void console.log(JSON.stringify(a.map(f),null,2));if(r.objects){let e=a.flatMap(e=>e.nodes.map(o=>`${e.filePath}: ${o.name} (${o.type})`));console.log(e.join("\n"));return}if(r.materials){let e=a.flatMap(e=>e.materials.map(o=>`${e.filePath}: ${o.name}`));console.log(e.join("\n"));return}if(r.morphs){let e=[];for(let o of a)for(let[t,n]of o.morphTargets)e.push(`${o.filePath}: ${t} → ${n.join(", ")}`);if(0===e.length)return void i.info("No morph targets found in any file");console.log(e.join("\n"));return}if(r.animations){let e=a.flatMap(e=>e.animations.map(o=>`${e.filePath}: ${o.name} (${o.duration}s, ${o.channelCount} ch)`));if(0===e.length)return void i.info("No animations found in any file");console.log(e.join("\n"));return}console.log(formatSummaryTable(a))}catch(e){e instanceof Error?i.error(e.message):i.error("Unexpected error during asset inspection",e),await t(1)}};

package/dist/phoenix/commands/list-environments.js

@@ -1 +1 @@
-import{runCommand as e}from"../utils/index.js";export const runListEnvironmentsCommand=async(n,r)=>{let{logger:t}=r;try{t.warn("DEPRECATED: environment:list command is deprecated, switch to a new workflow and use the prepare environment flow instead"),t.step("Listing deployment environments");let r=["list"];n?.server&&r.push("--server",`"${n.server}"`),n?.apiKey&&r.push("--apiKey",`"${n.apiKey}"`),await e({command:"deployment-cli",args:r,description:"Listing environments"},{logger:t})}catch(e){t.error(`Failed to list environments: ${e instanceof Error?e.message:String(e)}`,e),process.exit(1)}};
+import{exitCli as e}from"../services/index.js";import{runCommand as n}from"../utils/index.js";export const runListEnvironmentsCommand=async(r,t)=>{let{logger:i}=t;try{i.warn("DEPRECATED: environment:list command is deprecated, switch to a new workflow and use the prepare environment flow instead"),i.step("Listing deployment environments");let e=["list"];r?.server&&e.push("--server",`"${r.server}"`),r?.apiKey&&e.push("--apiKey",`"${r.apiKey}"`),await n({command:"deployment-cli",args:e,description:"Listing environments"},{logger:i})}catch(n){i.error(`Failed to list environments: ${n instanceof Error?n.message:String(n)}`,n),await e(1)}};

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

@@ -37,5 +37,8 @@ export declare const startLoginCallbackListener: (props: LoginCallbackListenerPr
  * one-time code to this CLI's loopback listener, and the CLI exchanges it with its PKCE verifier for an API token.
  * The browser waits on the callback meanwhile and ends on Studio's page for the outcome.
  */
-export declare const runLoginCommand: (props: LoginCommandProps, { logger }: CommandContext) => Promise<void>;
+export declare const runLoginCommand: (props: LoginCommandProps, { logger }: CommandContext) => Promise<{
+    userId: string;
+    workspaceId: string;
+} | undefined>;
 export {};

package/dist/phoenix/commands/login.js

@@ -1,4 +1,4 @@
-import{spawn as e}from"node:child_process";import{createHash as t,randomBytes as r}from"node:crypto";import{createServer as o}from"node:http";import{hostname as n}from"node:os";import{createApiBaseClient as s}from"#package/client";import{getServerCredentials as i,saveServerCredentials as a}from"../services/index.js";let l={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"},c=(e,t)=>`<!doctype html><html><head><meta charset="utf-8"><title>${e}</title></head><body style="font-family:system-ui,sans-serif;display:grid;place-items:center;height:100vh;margin:0"><main style="text-align:center"><h1>${e}</h1><p>${t.replace(/[&<>"']/g,e=>l[e]??e)}</p></main></body></html>`,d=(e,t,r,o)=>new Promise(n=>{e.destroyed?n():(e.once("close",n),e.writeHead(t,{...r,connection:"close"}).end(o))});export const startLoginCallbackListener=async e=>{let{state:t,studioUrl:r,customer:n}=e,s=(e,t)=>{let o=new URL(e,r);return o.searchParams.set("customer",n),t&&o.searchParams.set("name",t),o.toString()},i=null,a=!1,l=new Promise((e,t)=>{i={resolve:e,reject:t}}),m=o((e,r)=>{let o=new URL(e.url??"/","http://127.0.0.1"),n=o.searchParams.get("code"),l="access_denied"===o.searchParams.get("error");if("/callback"!==o.pathname)return void r.writeHead(404).end();if(o.searchParams.get("state")!==t||a||!n&&!l){d(r,400,{"content-type":"text/html"},c("Sign-in failed","This response does not belong to the waiting CLI. Run phoenix login again.")),a||i?.reject(Error("The sign-in response did not match this CLI session. Run `phoenix login` again."));return}if(a=!0,l||!n)return void d(r,302,{location:s("/builder/cli-login/denied",null)}).then(()=>{i?.reject(Error("The sign-in was denied in Studio. Run `phoenix login` again to sign in."))});let m=o.searchParams.get("name");i?.resolve({code:n,tokenName:m,finish:e=>e.signedIn?d(r,302,{location:s("/builder/cli-login/done",m)}):d(r,200,{"content-type":"text/html"},c("Sign-in failed",e.message))})}),h=await new Promise((e,t)=>{m.once("error",t),m.listen(0,"127.0.0.1",()=>{let r=m.address();null===r||"string"==typeof r?t(Error("The login callback listener did not get a port. Run `phoenix login` again.")):e(r.port)})}),u=setTimeout(()=>{i?.reject(Error("Nobody approved the sign-in within 5 minutes. Run `phoenix login` again."))},3e5);return{port:h,callback:l,close:()=>{clearTimeout(u),m.close()}}};let m=async(e,t)=>{try{let{error:r,response:o}=await s(e).DELETE("/auth/token",{headers:{authorization:`Bearer ${t}`,"content-type":null}});return r&&401!==o.status?r.message:null}catch(e){return e instanceof Error?e.message:String(e)}},h=async(e,t)=>{let{data:r,error:o}=await s(e.serverUrl).POST("/auth/token",{body:t});if(o||!r)throw Error(`The server did not accept the sign-in: ${o?.message??"no response"}`);if(r.customer.slug!==e.customer)throw await m(e.serverUrl,r.token),Error(`The sign-in was approved in workspace "${r.customer.slug}", not "${e.customer}". Check --region or --studioUrl and run \`phoenix login ${e.customer}\` again.`);let n=await i(e.serverUrl),l=await a(e.serverUrl,{token:r.token,userId:r.userId,customerSlug:r.customer.slug,customerName:r.customer.name,studioUrl:e.studioUrl,createdAt:new Date().toISOString()}),c=n?await m(e.serverUrl,n.token):null;return{customerName:r.customer.name,path:l,revokeError:c}};export const runLoginCommand=async(o,{logger:s})=>{let i=r(32).toString("base64url"),a=t("sha256").update(i).digest("base64url"),l=r(16).toString("base64url"),c=n(),d=`phoenix CLI on ${c}`,m=await startLoginCallbackListener({state:l,studioUrl:o.studioUrl,customer:o.customer});try{let t=new URL("/builder/cli-login",o.studioUrl);t.searchParams.set("customer",o.customer),t.searchParams.set("port",String(m.port)),t.searchParams.set("state",l),t.searchParams.set("challenge",a),t.searchParams.set("name",d),t.searchParams.set("host",c),t.searchParams.set("started",String(Date.now())),s.step(`Signing in to workspace "${o.customer}" on ${o.serverUrl}`),s.info(`Approve the CLI in your browser:
+import{spawn as e}from"node:child_process";import{createHash as t,randomBytes as r}from"node:crypto";import{createServer as o}from"node:http";import{hostname as n}from"node:os";import{z as s}from"zod";import{createApiBaseClient as i}from"#package/client";import{getServerCredentials as a,saveServerCredentials as l}from"../services/index.js";let c=s.string().uuid(),d={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"},m=(e,t)=>`<!doctype html><html><head><meta charset="utf-8"><title>${e}</title></head><body style="font-family:system-ui,sans-serif;display:grid;place-items:center;height:100vh;margin:0"><main style="text-align:center"><h1>${e}</h1><p>${t.replace(/[&<>"']/g,e=>d[e]??e)}</p></main></body></html>`,u=(e,t,r,o)=>new Promise(n=>{e.destroyed?n():(e.once("close",n),e.writeHead(t,{...r,connection:"close"}).end(o))});export const startLoginCallbackListener=async e=>{let{state:t,studioUrl:r,customer:n}=e,s=(e,t)=>{let o=new URL(e,r);return o.searchParams.set("customer",n),t&&o.searchParams.set("name",t),o.toString()},i=null,a=!1,l=new Promise((e,t)=>{i={resolve:e,reject:t}}),c=o((e,r)=>{let o=new URL(e.url??"/","http://127.0.0.1"),n=o.searchParams.get("code"),l="access_denied"===o.searchParams.get("error");if("/callback"!==o.pathname)return void r.writeHead(404).end();if(o.searchParams.get("state")!==t||a||!n&&!l){u(r,400,{"content-type":"text/html"},m("Sign-in failed","This response does not belong to the waiting CLI. Run phoenix login again.")),a||i?.reject(Error("The sign-in response did not match this CLI session. Run `phoenix login` again."));return}if(a=!0,l||!n)return void u(r,302,{location:s("/builder/cli-login/denied",null)}).then(()=>{i?.reject(Error("The sign-in was denied in Studio. Run `phoenix login` again to sign in."))});let c=o.searchParams.get("name");i?.resolve({code:n,tokenName:c,finish:e=>e.signedIn?u(r,302,{location:s("/builder/cli-login/done",c)}):u(r,200,{"content-type":"text/html"},m("Sign-in failed",e.message))})}),d=await new Promise((e,t)=>{c.once("error",t),c.listen(0,"127.0.0.1",()=>{let r=c.address();null===r||"string"==typeof r?t(Error("The login callback listener did not get a port. Run `phoenix login` again.")):e(r.port)})}),h=setTimeout(()=>{i?.reject(Error("Nobody approved the sign-in within 5 minutes. Run `phoenix login` again."))},3e5);return{port:d,callback:l,close:()=>{clearTimeout(h),c.close()}}};let h=async(e,t)=>{try{let{error:r,response:o}=await i(e).DELETE("/auth/token",{headers:{authorization:`Bearer ${t}`,"content-type":null}});return r&&401!==o.status?r.message:null}catch(e){return e instanceof Error?e.message:String(e)}},g=async(e,t)=>{let{data:r,error:o}=await i(e.serverUrl).POST("/auth/token",{body:t});if(o||!r)throw Error(`The server did not accept the sign-in: ${o?.message??"no response"}`);if(r.customer.slug!==e.customer)throw await h(e.serverUrl,r.token),Error(`The sign-in was approved in workspace "${r.customer.slug}", not "${e.customer}". Check --region or --studioUrl and run \`phoenix login ${e.customer}\` again.`);let n=await a(e.serverUrl),s=c.safeParse(r.customer.id),d=await l(e.serverUrl,{token:r.token,userId:r.userId,...s.success?{customerId:s.data}:{},customerSlug:r.customer.slug,customerName:r.customer.name,studioUrl:e.studioUrl,createdAt:new Date().toISOString()}),m=n?await h(e.serverUrl,n.token):null;return{customerName:r.customer.name,path:d,revokeError:m,telemetryAssociation:s.success?{userId:r.userId,workspaceId:s.data}:void 0}};export const runLoginCommand=async(o,{logger:s})=>{let i=r(32).toString("base64url"),a=t("sha256").update(i).digest("base64url"),l=r(16).toString("base64url"),c=n(),d=`phoenix CLI on ${c}`,m=await startLoginCallbackListener({state:l,studioUrl:o.studioUrl,customer:o.customer});try{let t=new URL("/builder/cli-login",o.studioUrl);t.searchParams.set("customer",o.customer),t.searchParams.set("port",String(m.port)),t.searchParams.set("state",l),t.searchParams.set("challenge",a),t.searchParams.set("name",d),t.searchParams.set("host",c),t.searchParams.set("started",String(Date.now())),s.step(`Signing in to workspace "${o.customer}" on ${o.serverUrl}`),s.info(`Approve the CLI in your browser:
 
   ${t.toString()}
-`),o.open&&(t=>{let[r,o]="darwin"===process.platform?["open",[t]]:"win32"===process.platform?["rundll32",["url.dll,FileProtocolHandler",t]]:["xdg-open",[t]];e(r,o,{stdio:"ignore",detached:!0}).on("error",()=>void 0).unref()})(t.toString());let r=await m.callback;try{let e=await h(o,{code:r.code,codeVerifier:i,port:m.port,name:d});e.revokeError&&s.warn(`The server did not revoke the token this sign-in replaces (${e.revokeError}). It stays valid on the server. Contact Phoenix support to revoke it.`),await r.finish({signedIn:!0}),s.success(`Signed in to ${e.customerName}. The token is stored in ${e.path}; revoke it with phoenix logout.`)}catch(e){throw await r.finish({signedIn:!1,message:e instanceof Error?e.message:String(e)}),e}}finally{m.close()}};
+`),o.open&&(t=>{let[r,o]="darwin"===process.platform?["open",[t]]:"win32"===process.platform?["rundll32",["url.dll,FileProtocolHandler",t]]:["xdg-open",[t]];e(r,o,{stdio:"ignore",detached:!0}).on("error",()=>void 0).unref()})(t.toString());let r=await m.callback;try{let e=await g(o,{code:r.code,codeVerifier:i,port:m.port,name:d});return e.revokeError&&s.warn(`The server did not revoke the token this sign-in replaces (${e.revokeError}). It stays valid on the server. Contact Phoenix support to revoke it.`),await r.finish({signedIn:!0}),s.success(`Signed in to ${e.customerName}. The token is stored in ${e.path}; revoke it with phoenix logout.`),e.telemetryAssociation}catch(e){throw await r.finish({signedIn:!1,message:e instanceof Error?e.message:String(e)}),e}}finally{m.close()}};

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

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