@salsita-ai/sdk 0.50.0-develop.f16492b14e → 0.50.0-develop.f354d3576d

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/lingui.d.ts

@@ -1,10 +1,10 @@
 import { type Logger } from '../utils/index.js';
 /**
  * The project's Lingui configuration, which sync generates, relative to the project root. The Lingui
- * CLI, the Lingui Vite plugin and the Lingui macros in the Vite builds are given this path, so a
- * `.linguirc` that earlier SDK versions left in the project root is not read. Lingui 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
+ * 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";

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

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

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

@@ -1,7 +1,9 @@
 import { type ViteDevServer } from 'vite';
-import type { ApplicationSpec } from '#package/application-spec';
 import type { Logger } from '../utils/index.js';
+import type { DeploymentPreparationService } from './deployment/index.js';
+import type { LinguiWatcher } from './lingui-watcher.js';
 import type { PhoenixPubSub } from './phoenix-pubsub.js';
+import type { PhoenixStore } from './phoenix-store.js';
 import type { VariantFileEdit } from './variant-file-session.js';
 export declare const WATCH_PATTERNS: string[];
 export declare const IGNORED_PATTERNS: string[];
@@ -9,9 +11,6 @@ export declare const IGNORED_PATTERNS: string[];
 export interface ApplicationSpecProjectWatcherConfig {
     readonly pubsub: PhoenixPubSub;
     readonly logger: Logger;
-    /** Called with the application spec of every rebuild that succeeded. */
-    readonly onRebuilt?: (applicationSpec: ApplicationSpec) => void;
-    readonly onViteServerChange?: (viteServer: ViteDevServer) => void;
     readonly sdkVersion: string;
     readonly projectSlug: string;
     readonly environmentSlug: string;
@@ -20,6 +19,12 @@ export interface ApplicationSpecProjectWatcherConfig {
     readonly inlineTemplates: boolean;
     readonly useServer: boolean;
 }
+/** Services the watcher notifies after a rebuild; the store owns its replaceable Vite handle. */
+export interface ApplicationSpecProjectWatcherContext {
+    readonly store: PhoenixStore;
+    readonly linguiWatcher: LinguiWatcher | undefined;
+    readonly deploymentPreparation: DeploymentPreparationService | undefined;
+}
 /**
  * Application-spec project watcher with layered caching via {@link ApplicationSpecBuilder}:
  *
@@ -31,22 +36,20 @@ export interface ApplicationSpecProjectWatcherConfig {
  * Rebuilds are serialized via PromiseQueue(1).
  */
 export declare class ApplicationSpecProjectWatcher {
+    private readonly context;
     private watcher;
     private subscription;
     private readonly rebuildQueue;
     /** Each watcher event emits the changed source path; debounced + buffered into batches. */
     private readonly changeSubject$;
-    private viteServer;
     private readonly pubsub;
     private readonly logger;
-    private readonly onRebuilt?;
-    private readonly onViteServerChange?;
     private readonly builder;
     private readonly useServer;
     private isShuttingDown;
     private suspended;
     private readonly heldChanges;
-    constructor(config: ApplicationSpecProjectWatcherConfig);
+    constructor(config: ApplicationSpecProjectWatcherConfig, context: ApplicationSpecProjectWatcherContext);
     start(viteServer: ViteDevServer): void;
     /** Rebuilds a batch a variant comparison wrote, at once and without the server work of a source change. */
     applyVariantFiles(files: readonly VariantFileEdit[]): void;

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

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

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

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

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

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

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

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

package/dist/phoenix/services/deployment/index.js

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

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

@@ -1,7 +1,8 @@
 export type { BrowserConsoleEvent, DataRequest, DataResult, EditorContextData, EditorLifecycleStatus, EditorStateData, MockTemplateUpdateEvent, SceneRequest, SceneResult, ScreenshotRequest, ScreenshotResult, SpecUpdateEvent, StateRequest, StateResult, StateSection, } from './phoenix-pubsub.js';
 export { PhoenixPubSub } from './phoenix-pubsub.js';
 export { PhoenixStore } from './phoenix-store.js';
-export { PhoenixApplication } from './phoenix-application.js';
+export { DeploymentPreparationService, readGeneratedEnvMarkers } from './deployment/index.js';
+export { PhoenixApplication, type PhoenixApplicationProps, type PhoenixApplicationContext, type PhoenixDevelopmentOptions, type EditorServerHandle, } from './session/index.js';
 export { VariantFileSession } from './variant-file-session.js';
 export { VariantPreviewService } from './variant-preview-service.js';
 export { MockTemplateWatcher, type MockTemplateWatcherConfig } from './mock-template-watcher.js';

package/dist/phoenix/services/index.js

@@ -1 +1 @@
-export{PhoenixPubSub}from"./phoenix-pubsub.js";export{PhoenixStore}from"./phoenix-store.js";export{PhoenixApplication}from"./phoenix-application.js";export{VariantFileSession}from"./variant-file-session.js";export{VariantPreviewService}from"./variant-preview-service.js";export{MockTemplateWatcher}from"./mock-template-watcher.js";export{ApplicationSpecProjectWatcher}from"./application-spec-project-watcher.js";export{ApplicationSpecStoryWatcher}from"./application-spec-story-watcher.js";export{LinguiWatcher}from"./lingui-watcher.js";export{bootstrapLinguiCatalogs,extractAndCompileLingui}from"../lingui/index.js";export{loadMockTemplates,parseMockTemplateYaml}from"./spec-files.js";export{LOG_STREAMS,LogBus}from"./log-bus.js";export{createBusLogger}from"./bus-logger.js";export{patchConsole}from"./console-capture.js";export{WebhookTunnelMonitor}from"./webhook-tunnel-monitor.js";export{compileWithSwc,watchWithSwc}from"./swc.js";export{STORY_DEV_MARKER_PATH,readActiveStoryDevMarker}from"./story-dev-marker.js";export{composeDefaultBanner}from"./phx-banner-plugin.js";export{getViteBuildConfigs,getViteDevConfig,setViteLogSink}from"./vite-config.js";export{getServerCredentials,removeServerCredentials,saveServerCredentials}from"./cli-credentials.js";export{exitCli,setBeforeCliExit}from"./cli-exit.js";export{createSourceArchive,extractSourceArchive}from"./source-archive.js";export{resolveSignedInDevelopmentEnvironment}from"./signed-in-development-environment.js";export{createTelemetryClient,resolveTelemetryCommand}from"./telemetry/index.js";export{DEFAULT_PHOENIX_REGION,PHOENIX_REGIONS,PUBLIC_PHOENIX_REGIONS,getRegionServerUrl,getRegionStudioUrl}from"./phoenix-regions.js";
+export{PhoenixPubSub}from"./phoenix-pubsub.js";export{PhoenixStore}from"./phoenix-store.js";export{DeploymentPreparationService,readGeneratedEnvMarkers}from"./deployment/index.js";export{PhoenixApplication}from"./session/index.js";export{VariantFileSession}from"./variant-file-session.js";export{VariantPreviewService}from"./variant-preview-service.js";export{MockTemplateWatcher}from"./mock-template-watcher.js";export{ApplicationSpecProjectWatcher}from"./application-spec-project-watcher.js";export{ApplicationSpecStoryWatcher}from"./application-spec-story-watcher.js";export{LinguiWatcher}from"./lingui-watcher.js";export{bootstrapLinguiCatalogs,extractAndCompileLingui}from"../lingui/index.js";export{loadMockTemplates,parseMockTemplateYaml}from"./spec-files.js";export{LOG_STREAMS,LogBus}from"./log-bus.js";export{createBusLogger}from"./bus-logger.js";export{patchConsole}from"./console-capture.js";export{WebhookTunnelMonitor}from"./webhook-tunnel-monitor.js";export{compileWithSwc,watchWithSwc}from"./swc.js";export{STORY_DEV_MARKER_PATH,readActiveStoryDevMarker}from"./story-dev-marker.js";export{composeDefaultBanner}from"./phx-banner-plugin.js";export{getViteBuildConfigs,getViteDevConfig,setViteLogSink}from"./vite-config.js";export{getServerCredentials,removeServerCredentials,saveServerCredentials}from"./cli-credentials.js";export{exitCli,setBeforeCliExit}from"./cli-exit.js";export{createSourceArchive,extractSourceArchive}from"./source-archive.js";export{resolveSignedInDevelopmentEnvironment}from"./signed-in-development-environment.js";export{createTelemetryClient,resolveTelemetryCommand}from"./telemetry/index.js";export{DEFAULT_PHOENIX_REGION,PHOENIX_REGIONS,PUBLIC_PHOENIX_REGIONS,getRegionServerUrl,getRegionStudioUrl}from"./phoenix-regions.js";

package/dist/phoenix/services/phoenix-store.d.ts

@@ -1,4 +1,5 @@
 import { BehaviorSubject } from 'rxjs';
+import type { ViteDevServer } from 'vite';
 /**
  * A frontend file script or standalone HTML proposal served from `.phoenix/variants/`.
  */
@@ -44,5 +45,7 @@ export interface VariantPreviewState {
  * editor server reaches it only through them. Events that carry no state stay on PhoenixPubSub.
  */
 export declare class PhoenixStore {
+    readonly viteServer$: BehaviorSubject<ViteDevServer | null>;
+    readonly reportedFingerprint$: BehaviorSubject<string | null>;
     readonly variantPreview$: BehaviorSubject<VariantPreviewState>;
 }

package/dist/phoenix/services/phoenix-store.js

@@ -1 +1 @@
-import{BehaviorSubject as e}from"rxjs";export class PhoenixStore{variantPreview$=new e({open:null,activeChoice:null,unclaimed:null})}
+import{BehaviorSubject as e}from"rxjs";export class PhoenixStore{viteServer$=new e(null);reportedFingerprint$=new e(null);variantPreview$=new e({open:null,activeChoice:null,unclaimed:null})}

package/dist/phoenix/services/session/editor-server-handle.d.ts

@@ -0,0 +1,5 @@
+/** A session-owned editor transport, including the result of binding its port. */
+export interface EditorServerHandle {
+    readonly ready: Promise<void>;
+    readonly close: () => Promise<void>;
+}

package/dist/phoenix/services/session/editor-server-handle.js

@@ -0,0 +1 @@
+export{};

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

@@ -0,0 +1,2 @@
+export { PhoenixApplication, type PhoenixApplicationProps, type PhoenixApplicationContext, type PhoenixDevelopmentOptions, } from './phoenix-application.js';
+export type { EditorServerHandle } from './editor-server-handle.js';

package/dist/phoenix/services/session/index.js

@@ -0,0 +1 @@
+export{PhoenixApplication}from"./phoenix-application.js";

package/dist/phoenix/services/session/phoenix-application.d.ts

@@ -0,0 +1,82 @@
+import { Subject } from 'rxjs';
+import { createServer } from 'vite';
+import { type Logger } from '../../utils/index.js';
+import { DeploymentPreparationService } from '../deployment/index.js';
+import { type DevelopmentCredential } from '../development-credential.js';
+import { LinguiWatcher } from '../lingui-watcher.js';
+import { LogBus } from '../log-bus.js';
+import { type BrowserConsoleEvent, PhoenixPubSub } from '../phoenix-pubsub.js';
+import { PhoenixStore } from '../phoenix-store.js';
+import { VariantPreviewService } from '../variant-preview-service.js';
+import { WebhookTunnelMonitor } from '../webhook-tunnel-monitor.js';
+import type { EditorServerHandle } from './editor-server-handle.js';
+/** Resolved inputs for one development session; the application constructs its service graph. */
+export interface PhoenixDevelopmentOptions {
+    readonly sdkVersion: string;
+    readonly projectSlug: string;
+    readonly environmentSlug: string;
+    readonly cliUseWorkspace: boolean | undefined;
+    readonly enableEditor: boolean | undefined;
+    readonly debug: boolean;
+    readonly withLingui: boolean;
+    readonly persistenceMode: string | undefined;
+    readonly force: boolean;
+    readonly serverUrl: string | undefined;
+    readonly credential: DevelopmentCredential | undefined;
+    readonly skipUpload: boolean;
+}
+export interface PhoenixApplicationProps {
+    readonly projectRoot: string;
+    readonly mode: 'dev' | 'story';
+    readonly development: PhoenixDevelopmentOptions | undefined;
+    readonly editorPort: number | undefined;
+}
+/** Host adapters for the editor transport and terminal presentation at lifecycle boundaries. */
+export interface PhoenixApplicationContext {
+    readonly logger: Logger;
+    readonly createEditorServer: (props: {
+        readonly port: number;
+        readonly application: PhoenixApplication;
+        readonly logger: Logger;
+        readonly debug: boolean;
+    }) => EditorServerHandle;
+    readonly onProjectPrepared: (logs: LogBus) => void;
+    readonly onStartupFailure: (error: unknown) => void;
+    readonly onBrowserConsole: (event: BrowserConsoleEvent, logs: LogBus) => void;
+}
+/** Composes, starts and closes one dev or story session, including resources acquired during a failed start. */
+export declare class PhoenixApplication {
+    private readonly props;
+    private readonly context;
+    readonly store: PhoenixStore;
+    readonly pubsub: PhoenixPubSub;
+    readonly failures$: Subject<Error>;
+    private readonly logsValue;
+    private readonly tunnelMonitorValue;
+    private readonly deploymentPreparationValue;
+    private variantPreviewsValue;
+    private linguiWatcherValue;
+    private projectWatcher;
+    private storyWatcher;
+    private mockTemplateWatcher;
+    private editorServer;
+    private webhookTunnel;
+    private browserConsoleSubscription;
+    private startPromise;
+    private closePromise;
+    constructor(props: PhoenixApplicationProps, context: PhoenixApplicationContext);
+    get logs(): LogBus | undefined;
+    get tunnelMonitor(): WebhookTunnelMonitor | undefined;
+    get deploymentPreparation(): DeploymentPreparationService | undefined;
+    get projectRoot(): string;
+    get mode(): 'dev' | 'story';
+    get variantPreviews(): VariantPreviewService | undefined;
+    get linguiWatcher(): LinguiWatcher | undefined;
+    start(): Promise<Awaited<ReturnType<typeof createServer>> | undefined>;
+    close(): Promise<void>;
+    private startSession;
+    private startEditor;
+    private startDevelopment;
+    private assertStarting;
+    private closeResources;
+}

package/dist/phoenix/services/session/phoenix-application.js

@@ -0,0 +1,2 @@
+import{Subject as e}from"rxjs";import{createServer as t}from"vite";import{resolveGeneratedEnvFile as o}from"@salsita-ai/common/env";import{generateProjectFiles as r,getDeploymentFingerprint as s}from"../../application-spec/index.js";import{exists as i}from"../../utils/index.js";import{buildWebhooks as n,webhookLogContext as a}from"../../webhooks/index.js";import{ApplicationSpecProjectWatcher as l}from"../application-spec-project-watcher.js";import{ApplicationSpecStoryWatcher as c}from"../application-spec-story-watcher.js";import{DeploymentPreparationService as h,readGeneratedEnvMarkers as p}from"../deployment/index.js";import{getDevelopmentCredentialHint as u}from"../development-credential.js";import{LinguiWatcher as m}from"../lingui-watcher.js";import{LogBus as g}from"../log-bus.js";import{MockTemplateWatcher as d}from"../mock-template-watcher.js";import{PhoenixPubSub as v}from"../phoenix-pubsub.js";import{PhoenixStore as w}from"../phoenix-store.js";import{VariantPreviewService as b}from"../variant-preview-service.js";import{getViteDevConfig as S}from"../vite-config.js";import{createWebhookTunnelTransport as E,readOrCreateTunnelSessionId as x,startWebhookService as f}from"../webhook-service/index.js";import{WebhookTunnelMonitor as P}from"../webhook-tunnel-monitor.js";export class PhoenixApplication{props;context;store=new w;pubsub=new v;failures$=new e;logsValue;tunnelMonitorValue;deploymentPreparationValue;variantPreviewsValue;linguiWatcherValue;projectWatcher;storyWatcher;mockTemplateWatcher;editorServer;webhookTunnel;browserConsoleSubscription;startPromise;closePromise;constructor(e,t){this.props=e,this.context=t;let o="dev"===e.mode?e.development:void 0,r=o&&(!o.persistenceMode||"server"===o.persistenceMode);this.logsValue="dev"===e.mode?new g:void 0,this.tunnelMonitorValue=r&&o.serverUrl?new P(o.serverUrl):void 0,this.deploymentPreparationValue=r&&o.serverUrl&&o.credential?new h({serverUrl:o.serverUrl,credential:o.credential,projectSlug:o.projectSlug,environmentSlug:o.environmentSlug,sdkVersion:o.sdkVersion},{store:this.store,get logger(){return t.logger}}):void 0}get logs(){return this.logsValue}get tunnelMonitor(){return this.tunnelMonitorValue}get deploymentPreparation(){return this.deploymentPreparationValue}get projectRoot(){return this.props.projectRoot}get mode(){return this.props.mode}get variantPreviews(){return this.variantPreviewsValue}get linguiWatcher(){return this.linguiWatcherValue}start(){return this.startPromise??=this.startSession(),this.startPromise}close(){return this.closePromise??=this.closeResources(this.context.logger),this.closePromise}async startSession(){try{if(this.assertStarting(),"story"===this.mode)return void await this.startEditor();let e=this.logs;if(!e)throw Error("Cannot start development: the application has no log bus.");return this.browserConsoleSubscription=this.pubsub.browserConsole$.subscribe(t=>this.context.onBrowserConsole(t,e)),await this.startDevelopment()}catch(e){throw this.closePromise||this.context.onStartupFailure(e),await this.close(),e}}async startEditor(){let e=this.props.editorPort;void 0!==e&&("dev"===this.mode&&this.context.logger.step("Starting editor WebSocket server"),this.editorServer=this.context.createEditorServer({port:e,application:this,logger:this.context.logger,debug:this.props.development?.debug??!1}),await this.editorServer.ready,this.assertStarting(),"dev"===this.mode&&this.context.logger.debug(`Editor WebSocket server started on port ${e}`),this.mockTemplateWatcher=new d({projectRoot:this.projectRoot,pubsub:this.pubsub,logger:this.context.logger}),this.mockTemplateWatcher.start(),"story"===this.mode&&(this.storyWatcher=new c({projectRoot:this.projectRoot,pubsub:this.pubsub,logger:this.context.logger}),this.storyWatcher.start()))}async startDevelopment(){let e=this.props.development,c=this.logs;if(!e||!c)throw Error("Cannot start development: session options are missing. Supply development options when constructing the application.");let{sdkVersion:h,projectSlug:g,environmentSlug:d,cliUseWorkspace:v,enableEditor:w,debug:P,withLingui:j,persistenceMode:y,force:k,serverUrl:V,credential:W,skipUpload:R}=e,{store:N,pubsub:T,deploymentPreparation:I,tunnelMonitor:_}=this;process.env.NODE_ENV="development",y&&(process.env.PERSISTENCE_MODE=y);let O=!y||"server"===y;if(O&&V&&(process.env.SERVER_URL=V),this.context.logger.step("Starting development mode"),!await i("spec"))throw Object.assign(Error('Spec folder not found. Run "phoenix init" first.'),{code:"SPEC_NOT_FOUND"});if(O&&(!V||!W))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.");this.context.logger.step("Building project files");let{templateFiles:D,applicationSpec:$}=await r({sdkVersion:h,projectSlug:g,environmentSlug:d,cliUseWorkspace:v,enableEditor:w,withLingui:j,force:k},{logger:this.context.logger});if(this.assertStarting(),this.context.logger.success("Project files built successfully"),O&&V&&W){let e=o("."),t=await p(e);k||t?.PHOENIX_PROJECT_SLUG!==g||t.PHOENIX_ENVIRONMENT_SLUG!==d||t.PHOENIX_SERVER_URL!==V||t.PHOENIX_DEPLOYMENT_FINGERPRINT!==s($)?(this.context.logger.step("Preparing development deployment"),await I?.prepareAtStartup({skipUpload:R,debug:P})):this.context.logger.debug(`${e} matches the current development environment, skipping prepare`)}if(this.assertStarting(),this.context.onProjectPrepared(c),j?(this.linguiWatcherValue=new m({logger:this.context.logger}),this.linguiWatcherValue.start()):this.context.logger.warn("Continuous Lingui updates are disabled; missing catalogs were bootstrapped at startup. Pass --withLingui or set WITH_LINGUI=true to enable."),O&&(this.context.logger.step("Building webhooks"),await a.run("webhook",async()=>{await n({experimental:!0,skipNodeEnvOverride:!0,webhookEntryPoint:"./.phoenix/.swc/.phoenix/webhook.js"})})),O&&V&&W){let e=o("."),t=await p(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.`);this.assertStarting();let r=await x();this.assertStarting();let s=await f({experimental:!0,transport:E({serverUrl:V,credential:W,projectSlug:g,environmentSlug:d}),rejectionHint:u(W,g),environmentSlug:d,deploymentId:t.DEPLOYMENT_ID,sessionId:r,onStatus:(e,o)=>{_?.setStatus(e,{deploymentId:t.DEPLOYMENT_ID,sessionId:r,message:o??null})},onRequest:e=>_?.record(e)});this.closePromise&&(await s.stop(),this.assertStarting()),this.webhookTunnel=s,_?.setStatus("waiting",{deploymentId:t.DEPLOYMENT_ID,sessionId:r}),s.stopped.catch(e=>{this.failures$.next(Error(`Webhook tunnel failed: ${e instanceof Error?e.message:String(e)}`)),this.close()}),this.context.logger.success("Webhook tunnel started")}this.assertStarting();let M=new l({pubsub:T,logger:this.context.logger,sdkVersion:h,projectSlug:g,environmentSlug:d,cliUseWorkspace:v,enableEditor:w??!0,inlineTemplates:!1,useServer:O},{store:N,linguiWatcher:this.linguiWatcherValue,deploymentPreparation:I});this.projectWatcher=M,this.variantPreviewsValue=new b({projectRoot:this.projectRoot},{store:N,logger:this.context.logger,projectWatcher:M}),w&&void 0!==this.props.editorPort&&await this.startEditor();let C=await S({templateFiles:D}),L=await t(C);return this.closePromise&&(await L.close(),this.assertStarting()),this.store.viteServer$.next(L),await L.listen(),this.assertStarting(),this.context.logger.step("Starting Vite dev server"),M.start(L),L}assertStarting(){if(this.closePromise)throw Error("Cannot continue startup: the session has already closed. Start a new Phoenix application.")}async closeResources(e){"dev"===this.mode&&e.debug("Shutting down...");let t="story"===this.mode?[{name:"story source watcher",close:()=>this.storyWatcher?.close()},{name:"mock-template watcher",close:()=>this.mockTemplateWatcher?.close()},{name:"editor server",close:()=>this.editorServer?.close()}]:[{name:"lingui watcher",close:()=>this.linguiWatcherValue?.close()},{name:"project watcher",close:()=>this.projectWatcher?.close()},{name:"mock template watcher",close:()=>this.mockTemplateWatcher?.close()},{name:"editor server",close:()=>this.editorServer?.close()},{name:"variant previews",close:()=>this.variantPreviewsValue?.dispose()},{name:"vite server",close:()=>this.store.viteServer$.value?.close()},{name:"webhook tunnel",close:()=>this.webhookTunnel?.stop()}],o=[];for(let r of t)try{"dev"===this.mode&&e.debug(`Shutting down ${r.name}`),await r.close()}catch(s){let t=s instanceof Error?s.message:String(s);"story"===this.mode?e.warn(`Failed to close the story-dev ${r.name}: ${t}. The process will continue shutting down.`):o.push(`${r.name}: ${t}`)}this.browserConsoleSubscription?.unsubscribe(),this.failures$.complete(),o.length>0&&e.warn(`Cleanup warnings:
+  ${o.join("\n  ")}`),"dev"===this.mode&&e.debug("Shutdown complete")}}

package/dist/phoenix/services/source-archive.d.ts

@@ -4,6 +4,8 @@ export interface SourceArchive {
     readonly fileCount: number;
     readonly size: number;
     readonly hasConversationLog: boolean;
+    /** Regular files packed from the project's `docs/` folder, which travel privately and are never published. */
+    readonly documentFileCount: number;
     readonly cleanup: () => Promise<void>;
 }
 /** What `extractSourceArchive` wrote and what it left out. */

package/dist/phoenix/services/source-archive.js

@@ -1 +1 @@
-import{execFile as e}from"node:child_process";import{createReadStream as r,createWriteStream as t}from"node:fs";import{lstat as o,mkdir as i,mkdtemp as a,readdir as n,rm as s,stat as c,writeFile as l}from"node:fs/promises";import{tmpdir as h}from"node:os";import{dirname as p,join as f}from"node:path";import{Transform as d}from"node:stream";import{pipeline as w}from"node:stream/promises";import{promisify as m}from"node:util";import{createGunzip as u}from"node:zlib";import{extract as g}from"tar-stream";import{isProjectFile as y,listProjectEntries as v}from"../application-spec/project-files.js";let x=m(e);export const createSourceArchive=async e=>{let r=(await n(e)).includes("conversation.log"),t=[...await v(e),...r?["conversation.log"]:[]],i=await Promise.all(t.map(async r=>({name:r,entry:await o(f(e,r))})));if(i.some(({name:e,entry:r})=>"conversation.log"===e&&r.isDirectory()))throw Error("conversation.log is a directory. Replace it with a regular transcript file and deploy again.");let p=i.filter(({entry:e})=>!e.isDirectory()&&(!e.isFile()||e.nlink>1)),d=i.filter(({entry:e})=>e.isFile()).map(({name:e})=>e);if(p.length>0)throw Error(`These project files are links or special files, which builds do not accept: ${p.map(({name:e})=>e).join(", ")}. Replace them with regular files and deploy again.`);if(0===d.length)throw Error(`No project files were found in ${e}, so there is nothing to deploy. Run phoenix deploy in the folder of an application-spec project.`);let w=await a(f(h(),"phoenix-deploy-")),m="sources.tgz",u=f(w,m),g=f(w,"files");try{await l(g,d.join("\0")),await x("tar",["-czf",m,"-C",e,"--null","-T",g],{cwd:w,env:{...process.env,COPYFILE_DISABLE:"1"}})}catch(r){await s(w,{recursive:!0,force:!0});let e=r instanceof Error?r.message:String(r);throw Error(`Packing the project with tar failed: ${e}. Check that tar is installed and on the PATH.`)}return{path:u,fileCount:d.length,size:(await c(u)).size,hasConversationLog:r,cleanup:()=>s(w,{recursive:!0,force:!0})}};let E=(e,...r)=>e instanceof Error&&"code"in e&&"string"==typeof e.code&&r.includes(e.code),j=async e=>{try{return 0===(await n(e)).length}catch(e){if(E(e,"ENOENT"))return!0;throw e}},T=class ArchiveRefusal extends Error{},b=e=>e.length>0&&!e.startsWith("/")&&!e.includes("\\")&&!/^[A-Za-z]:/.test(e)&&!/[\x00-\x1f\x7f]/.test(e)&&!e.split("/").includes("..");export const extractSourceArchive=async e=>{let o,a,{archivePath:n,targetDir:l}=e,h=(await c(n)).size;if(h>0xc800000)throw Error(`The source archive is ${h} bytes, over the 209715200 byte limit. Remove large files from the project and deploy again.`);if(!await j(l))throw Error(`The folder ${l} is not empty, and extracted sources must not mix with existing files. Extract into a new or empty folder.`);let m=g(),v=new AbortController,x=w(r(n),u(),(a=0,new d({transform(e,r,t){(a+=e.length)>0x40000000?t(new T("The source archive extracts to more than 1073741824 bytes. Remove large files from the project and deploy again.")):t(null,e)}})),m).catch(e=>{o??=e,v.abort()}),$=[],R=0,z=0;try{for await(let e of m){let{type:r}=e.header,o=e.header.name.replace(/^(\.\/)+/,""),a=JSON.stringify(o);if("directory"===r){e.resume();continue}if((z+=1)>1e5)throw new T("The source archive has more than 100000 files. Remove generated or unused files from the project and deploy again.");if(!b(o))throw new T(`The source archive contains ${a}, which is not a plain relative path inside the project. Pack the project with phoenix deploy.`);if("file"!==r)throw new T(`The source archive contains ${a}, which is a ${r??"special file"}. Builds accept only regular files; replace it with a regular file and deploy again.`);if(!y(o)){$.push(o),e.resume();continue}let n=f(l,...o.split("/"));try{await i(p(n),{recursive:!0}),await w(e,t(n,{flags:"wx"}),{signal:v.signal})}catch(e){if(E(e,"EEXIST","ENOTDIR","EISDIR"))throw new T(`The source archive contains ${a}, which repeats or collides with an earlier entry, so its content is ambiguous. Pack the project with phoenix deploy.`);throw e}R+=1}if(await x,void 0!==o)throw o}catch(t){let e=t instanceof T?t:o??t;if(m.destroy(),await x,await s(l,{recursive:!0,force:!0}),e instanceof T)throw e;let r=e instanceof Error?e.message:String(e);throw Error(`The source archive could not be read: ${r}. It is truncated or not a gzip tarball; pack the project with phoenix deploy.`)}return{fileCount:R,skipped:$}};
+import{execFile as e}from"node:child_process";import{createReadStream as r,createWriteStream as t}from"node:fs";import{lstat as o,mkdir as i,mkdtemp as a,readdir as n,rm as s,stat as c,writeFile as l}from"node:fs/promises";import{tmpdir as h}from"node:os";import{dirname as p,join as f}from"node:path";import{Transform as d}from"node:stream";import{pipeline as w}from"node:stream/promises";import{promisify as m}from"node:util";import{createGunzip as u}from"node:zlib";import{extract as g}from"tar-stream";import{isProjectFile as y,listProjectDocumentEntries as v,listProjectEntries as x,listProjectWorkspaceEntries as E}from"../application-spec/index.js";let j=m(e);export const createSourceArchive=async e=>{let r=(await n(e)).includes("conversation.log"),t=await x(e),i=await E(e),p=await v(e),d=[...t,...i,...p,...r?["conversation.log"]:[]],w=await Promise.all(d.map(async r=>({name:r,entry:await o(f(e,r))})));if(w.some(({name:e,entry:r})=>"conversation.log"===e&&r.isDirectory()))throw Error("conversation.log is a directory. Replace it with a regular transcript file and deploy again.");let m=w.filter(({entry:e})=>!e.isDirectory()&&(!e.isFile()||e.nlink>1)),u=w.filter(({entry:e})=>e.isFile()).map(({name:e})=>e),g=new Set(p);if(m.length>0)throw Error(`These project files are links or special files, which builds do not accept: ${m.map(({name:e})=>e).join(", ")}. Replace them with regular files and deploy again.`);if(!u.some(y))throw Error(`No project files were found in ${e}, so there is nothing to deploy. Run phoenix deploy in the folder of an application-spec project.`);let T=await a(f(h(),"phoenix-deploy-")),b="sources.tgz",$=f(T,b),R=f(T,"files");try{await l(R,u.join("\0")),await j("tar",["-czf",b,"-C",e,"--null","-T",R],{cwd:T,env:{...process.env,COPYFILE_DISABLE:"1"}})}catch(r){await s(T,{recursive:!0,force:!0});let e=r instanceof Error?r.message:String(r);throw Error(`Packing the project with tar failed: ${e}. Check that tar is installed and on the PATH.`)}return{path:$,fileCount:u.length,size:(await c($)).size,hasConversationLog:r,documentFileCount:u.filter(e=>g.has(e)).length,cleanup:()=>s(T,{recursive:!0,force:!0})}};let T=(e,...r)=>e instanceof Error&&"code"in e&&"string"==typeof e.code&&r.includes(e.code),b=async e=>{try{return 0===(await n(e)).length}catch(e){if(T(e,"ENOENT"))return!0;throw e}},$=class ArchiveRefusal extends Error{},R=e=>e.length>0&&!e.startsWith("/")&&!e.includes("\\")&&!/^[A-Za-z]:/.test(e)&&!/[\x00-\x1f\x7f]/.test(e)&&!e.split("/").includes("..");export const extractSourceArchive=async e=>{let o,a,{archivePath:n,targetDir:l}=e,h=(await c(n)).size;if(h>0xc800000)throw Error(`The source archive is ${h} bytes, over the 209715200 byte limit. Remove large files from the project and deploy again.`);if(!await b(l))throw Error(`The folder ${l} is not empty, and extracted sources must not mix with existing files. Extract into a new or empty folder.`);let m=g(),v=new AbortController,x=w(r(n),u(),(a=0,new d({transform(e,r,t){(a+=e.length)>0x40000000?t(new $("The source archive extracts to more than 1073741824 bytes. Remove large files from the project and deploy again.")):t(null,e)}})),m).catch(e=>{o??=e,v.abort()}),E=[],j=0,S=0;try{for await(let e of m){let{type:r}=e.header,o=e.header.name.replace(/^(\.\/)+/,""),a=JSON.stringify(o);if("directory"===r){e.resume();continue}if((S+=1)>1e5)throw new $("The source archive has more than 100000 files. Remove generated or unused files from the project and deploy again.");if(!R(o))throw new $(`The source archive contains ${a}, which is not a plain relative path inside the project. Pack the project with phoenix deploy.`);if("file"!==r)throw new $(`The source archive contains ${a}, which is a ${r??"special file"}. Builds accept only regular files; replace it with a regular file and deploy again.`);if(!y(o)){E.push(o),e.resume();continue}let n=f(l,...o.split("/"));try{await i(p(n),{recursive:!0}),await w(e,t(n,{flags:"wx"}),{signal:v.signal})}catch(e){if(T(e,"EEXIST","ENOTDIR","EISDIR"))throw new $(`The source archive contains ${a}, which repeats or collides with an earlier entry, so its content is ambiguous. Pack the project with phoenix deploy.`);throw e}j+=1}if(await x,void 0!==o)throw o}catch(t){let e=t instanceof $?t:o??t;if(m.destroy(),await x,await s(l,{recursive:!0,force:!0}),e instanceof $)throw e;let r=e instanceof Error?e.message:String(e);throw Error(`The source archive could not be read: ${r}. It is truncated or not a gzip tarball; pack the project with phoenix deploy.`)}return{fileCount:j,skipped:E}};

package/dist/phoenix/services/swc.d.ts

@@ -1,16 +1,17 @@
 import { type Logger } from '../utils/index.js';
 export interface SwcCompileProps {
-    readonly sourceDir?: string;
-    readonly outDir?: string;
+    readonly sourceDir: string;
+    readonly outDir: string;
+    readonly ignoredPaths: readonly string[];
 }
-export declare const compileWithSwc: (props?: SwcCompileProps, context?: {
+export declare const compileWithSwc: (props: SwcCompileProps, context?: {
     readonly logger: Logger;
 }) => Promise<void>;
 /**
  * Watch mode for SWC compilation
  * Watches for changes in TypeScript files and non-compilable files
  */
-export declare const watchWithSwc: (props?: SwcCompileProps, context?: {
+export declare const watchWithSwc: (props: SwcCompileProps, context?: {
     readonly logger: Logger;
 }) => Promise<{
     stop: () => Promise<void>;

package/dist/phoenix/services/swc.js

@@ -1,3 +1,3 @@
-import{transform as e}from"@swc/core";import{remove as t}from"fs-extra";import{copyFile as s,mkdir as o,readFile as a,writeFile as r}from"fs/promises";import{globby as i}from"globby";import{createRequire as c}from"node:module";import{dirname as l,relative as n,resolve as p}from"path";import{Subject as m}from"rxjs";import{watch as w}from"#package/watch";import{createLogger as d}from"../utils/index.js";let u=()=>({sourceMaps:!0,module:{type:"es6"},jsc:{target:"es2022",parser:{syntax:"typescript",tsx:!0},transform:{react:{runtime:"automatic"}},keepClassNames:!0,experimental:{plugins:[[c(import.meta.url).resolve("@lingui/swc-plugin"),{}]],cacheRoot:"node_modules/.cache/swc"}}}),f=async(e,t,a)=>{let r=process.cwd(),c=p(r,e),m=p(r,t),w=await i(["**/*.{html,css,json,txt,md}","**/.env*"],{cwd:c,ignore:["**/*.{spec,test}.{html,css,json,txt,md}","**/__tests__/**","**/__mocks__/**","**/tsconfig.json",".env.generated"],absolute:!1}),d=0,u=0;for(let e of w)try{let t=p(c,e),a=p(m,e);await o(l(a),{recursive:!0}),await s(t,a),d++}catch(t){u++,console.error(`Failed to copy ${n(r,p(c,e))}:`,t)}if(u>0)throw Error(`Failed to copy ${u} file(s)`);d>0&&a.debug(`Copied ${d} non-compilable file(s)`)};export const compileWithSwc=async(s,c)=>{let{sourceDir:m="src",outDir:w="./node_modules/.phoenix"}=s??{},g=c?.logger??d(),h=process.cwd(),_=p(h,m),x=p(h,w);await t(x);let y=await i(["**/*.{ts,tsx}"],{cwd:_,ignore:["**/*.{spec,test}.{ts,tsx}","**/__tests__/**","**/__mocks__/**"],absolute:!1}),b=u(),$=0,j=0;for(let t of y)try{let s=p(_,t),i=p(x,t.replace(/\.tsx?$/,".js")),c=await a(s,"utf-8"),n=await e(c,{...b,filename:s,sourceMaps:!0,outputPath:i});await o(l(i),{recursive:!0}),await r(i,n.code,"utf-8"),n.map&&await r(`${i}.map`,n.map,"utf-8"),$++}catch(e){j++,console.error(`Failed to compile ${n(h,p(_,t))}:`,e)}if(j>0)throw Error(`Failed to compile ${j} file(s)`);g.isDebug&&g.debug(`Compiled ${$} file(s) with swc`),await f(m,w,g)};let g=async(t,s,i)=>{let c=process.cwd(),n=p(c,s),m=p(c,i),w=u(),d=p(n,t),f=p(m,t.replace(/\.tsx?$/,".js")),g=await a(d,"utf-8"),h=await e(g,{...w,filename:d,sourceMaps:!0,outputPath:f});await o(l(f),{recursive:!0}),await r(f,h.code,"utf-8"),h.map&&await r(`${f}.map`,h.map,"utf-8")},h=async(e,t,a)=>{let r=process.cwd(),i=p(r,t),c=p(r,a),n=p(i,e),m=p(c,e);await o(l(m),{recursive:!0}),await s(n,m)};export const watchWithSwc=async(e,t)=>{let{sourceDir:s="src",outDir:o="./node_modules/.phoenix"}=e??{},a=t?.logger??d(),r=p(process.cwd(),s);a.isDebug&&a.step("Running initial SWC compilation"),await compileWithSwc({sourceDir:s,outDir:o},t),a.isDebug&&a.success("Initial compilation complete");let i=new m,c=w(["**/*.{ts,tsx,html,css,json,txt,md}","../.env*"],{cwd:r,ignored:["**/*.{spec,test}.{ts,tsx}","**/__tests__/**","**/cache.json"],persistent:!0,ignoreInitial:!0});return c.on("all",(e,t)=>{("change"===e||"add"===e)&&i.next({file:t,type:e})}),i.subscribe(async({file:e})=>{let t=n(r,p(r,e));try{e.match(/\.tsx?$/)?(await g(t,s,o),a.fileChanged(t)):(e.match(/\.(html|css|json|txt|md)$/)||e.match(/\.env/))&&(await h(t,s,o),a.fileChanged(t))}catch(e){a.error(`Failed to process ${t}`),a.isDebug&&console.error(e)}}),a.isDebug&&console.log(`
+import{transform as e}from"@swc/core";import{remove as t}from"fs-extra";import{copyFile as s,mkdir as o,readFile as a,writeFile as r}from"fs/promises";import{globby as i}from"globby";import{createRequire as c}from"node:module";import{dirname as l,relative as n,resolve as p}from"path";import{Subject as m}from"rxjs";import{watch as w}from"#package/watch";import{createLogger as u}from"../utils/index.js";let d=()=>({sourceMaps:!0,module:{type:"es6"},jsc:{target:"es2022",parser:{syntax:"typescript",tsx:!0},transform:{react:{runtime:"automatic"}},keepClassNames:!0,experimental:{plugins:[[c(import.meta.url).resolve("@lingui/swc-plugin"),{}]],cacheRoot:"node_modules/.cache/swc"}}}),f=async(e,t,a,r)=>{let c=process.cwd(),m=p(c,e),w=p(c,t),u=await i(["**/*.{html,css,json,txt,md}","**/.env*"],{cwd:m,ignore:[...a,"**/*.{spec,test}.{html,css,json,txt,md}","**/__tests__/**","**/__mocks__/**","**/tsconfig.json",".env.generated"],absolute:!1}),d=0,f=0;for(let e of u)try{let t=p(m,e),a=p(w,e);await o(l(a),{recursive:!0}),await s(t,a),d++}catch(t){f++,console.error(`Failed to copy ${n(c,p(m,e))}:`,t)}if(f>0)throw Error(`Failed to copy ${f} file(s)`);d>0&&r.debug(`Copied ${d} non-compilable file(s)`)};export const compileWithSwc=async(s,c)=>{let{sourceDir:m,outDir:w,ignoredPaths:g}=s,h=c?.logger??u(),_=process.cwd(),x=p(_,m),y=p(_,w);await t(y);let b=await i(["**/*.{ts,tsx}"],{cwd:x,ignore:[...g,"**/*.{spec,test}.{ts,tsx}","**/__tests__/**","**/__mocks__/**"],absolute:!1}),$=d(),j=0,v=0;for(let t of b)try{let s=p(x,t),i=p(y,t.replace(/\.tsx?$/,".js")),c=await a(s,"utf-8"),n=await e(c,{...$,filename:s,sourceMaps:!0,outputPath:i});await o(l(i),{recursive:!0}),await r(i,n.code,"utf-8"),n.map&&await r(`${i}.map`,n.map,"utf-8"),j++}catch(e){v++,console.error(`Failed to compile ${n(_,p(x,t))}:`,e)}if(v>0)throw Error(`Failed to compile ${v} file(s)`);h.isDebug&&h.debug(`Compiled ${j} file(s) with swc`),await f(m,w,g,h)};let g=async(t,s,i)=>{let c=process.cwd(),n=p(c,s),m=p(c,i),w=d(),u=p(n,t),f=p(m,t.replace(/\.tsx?$/,".js")),g=await a(u,"utf-8"),h=await e(g,{...w,filename:u,sourceMaps:!0,outputPath:f});await o(l(f),{recursive:!0}),await r(f,h.code,"utf-8"),h.map&&await r(`${f}.map`,h.map,"utf-8")},h=async(e,t,a)=>{let r=process.cwd(),i=p(r,t),c=p(r,a),n=p(i,e),m=p(c,e);await o(l(m),{recursive:!0}),await s(n,m)};export const watchWithSwc=async(e,t)=>{let{sourceDir:s,outDir:o,ignoredPaths:a}=e,r=t?.logger??u(),i=p(process.cwd(),s);r.isDebug&&r.step("Running initial SWC compilation"),await compileWithSwc({sourceDir:s,outDir:o,ignoredPaths:a},t),r.isDebug&&r.success("Initial compilation complete");let c=new m,l=w(["**/*.{ts,tsx,html,css,json,txt,md}","../.env*"],{cwd:i,ignored:[...a,"**/*.{spec,test}.{ts,tsx}","**/__tests__/**","**/cache.json"],persistent:!0,ignoreInitial:!0});return l.on("all",(e,t)=>{("change"===e||"add"===e)&&c.next({file:t,type:e})}),c.subscribe(async({file:e})=>{let t=n(i,p(i,e));try{e.match(/\.tsx?$/)?(await g(t,s,o),r.fileChanged(t)):(e.match(/\.(html|css|json|txt|md)$/)||e.match(/\.env/))&&(await h(t,s,o),r.fileChanged(t))}catch(e){r.error(`Failed to process ${t}`),r.isDebug&&console.error(e)}}),r.isDebug&&console.log(`
 👀 Watching ${s} for changes...
-`),{stop:async()=>{await c.close(),a.isDebug&&a.info("SWC watcher stopped")}}};
+`),{stop:async()=>{await l.close(),r.isDebug&&r.info("SWC watcher stopped")}}};