@@ -48,6 +48,8 @@ export class PreviewManager extends Context.Service<
4848 readonly open : (
4949 input : PreviewOpenInput & {
5050 readonly automationOwner ?: string ;
51+ /** Only the server browser selects how its page is presented. */
52+ readonly serverPageMode ?: PreviewSessionSnapshot [ "serverPageMode" ] ;
5153 /** Runs before the `opened` event publishes, so subscribers find state keyed by the tab. */
5254 readonly beforePublish ?: ( snapshot : PreviewSessionSnapshot ) => void ;
5355 } ,
@@ -58,6 +60,13 @@ export class PreviewManager extends Context.Service<
5860 readonly reportStatus : (
5961 input : PreviewReportStatusInput & { readonly serverControlled ?: boolean } ,
6062 ) => Effect . Effect < void , PreviewError > ;
63+ /** Publishes the backing page selected by the server; headless cannot be promoted later. */
64+ readonly setServerPageMode : (
65+ input : PreviewCloseInput & {
66+ readonly tabId : string ;
67+ readonly mode : "native" | "headless" ;
68+ } ,
69+ ) => Effect . Effect < PreviewSessionSnapshot , PreviewError > ;
6170 readonly requestReveal : (
6271 input : PreviewCloseInput & { readonly tabId : string ; readonly force : boolean } ,
6372 ) => Effect . Effect < void , PreviewError > ;
@@ -221,6 +230,9 @@ export const make = Effect.gen(function* PreviewManagerMake() {
221230 viewport : input . viewport ?? FILL_PREVIEW_VIEWPORT ,
222231 ...( input . profileId === undefined ? { } : { profileId : input . profileId } ) ,
223232 ...( runtime === undefined ? { } : { runtime } ) ,
233+ ...( runtime === "server" && input . serverPageMode !== undefined
234+ ? { serverPageMode : input . serverPageMode }
235+ : { } ) ,
224236 ...( runtime === "server" && input . automationOwner !== undefined
225237 ? { automationOwner : input . automationOwner }
226238 : { } ) ,
@@ -337,6 +349,40 @@ export const make = Effect.gen(function* PreviewManagerMake() {
337349 ) ;
338350 } ) ;
339351
352+ const setServerPageMode : PreviewManager [ "Service" ] [ "setServerPageMode" ] = Effect . fn (
353+ "PreviewManager.setServerPageMode" ,
354+ ) ( function * ( input ) {
355+ return yield * mutateExistingSession (
356+ input . threadId ,
357+ input . tabId ,
358+ Effect . fn ( "PreviewManager.setSessionPageMode" ) ( function * ( session ) {
359+ if ( session . snapshot . runtime !== "server" )
360+ return yield * new PreviewControlRequiredError ( { tabId : input . tabId } ) ;
361+ if (
362+ session . snapshot . serverPageMode === input . mode ||
363+ session . snapshot . serverPageMode === "headless"
364+ )
365+ return { next : session , emit : null , result : session . snapshot } ;
366+ const snapshot : PreviewSessionSnapshot = {
367+ ...session . snapshot ,
368+ serverPageMode : input . mode ,
369+ updatedAt : yield * currentIsoTimestamp ,
370+ } ;
371+ return {
372+ next : { ...session , snapshot } ,
373+ emit : {
374+ type : "resized" ,
375+ threadId : session . threadId ,
376+ tabId : session . tabId ,
377+ createdAt : snapshot . updatedAt ,
378+ snapshot,
379+ } ,
380+ result : snapshot ,
381+ } ;
382+ } ) ,
383+ ) ;
384+ } ) ;
385+
340386 const resize : PreviewManager [ "Service" ] [ "resize" ] = Effect . fn ( "PreviewManager.resize" ) (
341387 function * ( input ) {
342388 return yield * mutateExistingSession (
@@ -456,7 +502,8 @@ export const make = Effect.gen(function* PreviewManagerMake() {
456502
457503 const list : PreviewManager [ "Service" ] [ "list" ] = Effect . fn ( "PreviewManager.list" ) (
458504 function * ( input ) {
459- return yield * SynchronizedRef . get ( stateRef ) . pipe (
505+ // Events publish inside a mutation; their consumers must wait for its state commit.
506+ return yield * SynchronizedRef . modify ( stateRef , ( state ) => [ state , state ] as const ) . pipe (
460507 Effect . map ( ( state ) : PreviewListResult => ( {
461508 sessions : sessionsForThread ( state , input . threadId )
462509 . map ( ( s ) => s . snapshot )
@@ -504,6 +551,7 @@ export const make = Effect.gen(function* PreviewManagerMake() {
504551 requestReveal,
505552 navigate,
506553 reportStatus,
554+ setServerPageMode,
507555 resize,
508556 adjust,
509557 refresh,
0 commit comments