11import {
22 EnvironmentId ,
3+ ServerSelfUpdateError ,
34 ProviderInstanceId ,
45 ServerObservability ,
56 EnvironmentThemeId ,
@@ -16,12 +17,14 @@ import * as Duration from "effect/Duration";
1617import * as Effect from "effect/Effect" ;
1718import * as Exit from "effect/Exit" ;
1819import * as Fiber from "effect/Fiber" ;
20+ import * as Layer from "effect/Layer" ;
1921import * as Option from "effect/Option" ;
2022import * as Queue from "effect/Queue" ;
2123import * as Ref from "effect/Ref" ;
2224import * as Schema from "effect/Schema" ;
2325import * as Stream from "effect/Stream" ;
2426import * as SubscriptionRef from "effect/SubscriptionRef" ;
27+ import { AsyncResult , Atom , AtomRegistry } from "effect/reactivity" ;
2528import * as TestClock from "effect/testing/TestClock" ;
2629import { RpcClientError } from "effect/rpc" ;
2730import * as Socket from "effect/socket/Socket" ;
@@ -32,11 +35,15 @@ import {
3235 type PreparedConnection ,
3336} from "../connection/model.ts" ;
3437import * as EnvironmentSupervisor from "../connection/supervisor.ts" ;
38+ import * as EnvironmentRegistry from "../connection/registry.ts" ;
39+ import { RpcPermissionGuard } from "../rpc/client.ts" ;
3540import * as Persistence from "../platform/persistence.ts" ;
3641import type { WsRpcProtocolClient } from "../rpc/protocol.ts" ;
3742import type { RpcSession } from "../rpc/session.ts" ;
3843import {
3944 applyServerWelcomeEvent ,
45+ createServerEnvironmentAtoms ,
46+ serverUpdateStateAtom ,
4047 makeEnvironmentServerWelcomeState ,
4148 makeEnvironmentServerConfigState ,
4249 isLegacyUpdateHandoffLoss ,
@@ -216,6 +223,162 @@ describe("update restart reconnect nudges", () => {
216223 ) ;
217224} ) ;
218225
226+ describe ( "accepted server update recovery" , ( ) => {
227+ it . effect . each ( [
228+ { loss : "interrupt" , resumes : true } ,
229+ { loss : "socket" , resumes : true } ,
230+ { loss : "server_error" , resumes : false } ,
231+ { loss : "no_progress" , resumes : false } ,
232+ { loss : "cancel" , resumes : false } ,
233+ { loss : "socket" , method : "respawn" , resumes : true } ,
234+ { loss : "socket" , method : "desktop-managed" , resumes : false } ,
235+ ] as const ) ( "handles $loss with $method and recovery=$resumes" , ( scenario ) =>
236+ Effect . gen ( function * ( ) {
237+ const { loss, resumes } = scenario ;
238+ const method = "method" in scenario ? scenario . method : "boot-service" ;
239+ const observing = yield * Deferred . make < void > ( ) ;
240+ const cancelFiber = yield * Deferred . make < Fiber . Fiber < unknown , unknown > > ( ) ;
241+ const oldReadyObserved = yield * Deferred . make < void > ( ) ;
242+ const readyEvents =
243+ yield * Queue . unbounded < Parameters < typeof matchesServerUpdateReadyEvent > [ 1 ] > ( ) ;
244+ const config = {
245+ ...CONFIG ,
246+ environment : {
247+ ...CONFIG . environment ,
248+ serverVersion : "0.0.30" ,
249+ capabilities : { serverSelfUpdate : method , serverSelfUpdateProgress : true } ,
250+ } ,
251+ } as ServerConfig ;
252+ const client = {
253+ [ WS_METHODS . subscribeServerConfig ] : ( ) => Stream . never ,
254+ [ WS_METHODS . subscribeServerLifecycle ] : ( ) =>
255+ Stream . fromEffect ( Deferred . succeed ( observing , undefined ) ) . pipe (
256+ Stream . drain ,
257+ Stream . concat ( Stream . fromQueue ( readyEvents ) ) ,
258+ Stream . tap ( ( event ) =>
259+ event . payload . environment . serverVersion === "0.0.30"
260+ ? Deferred . succeed ( oldReadyObserved , undefined )
261+ : Effect . void ,
262+ ) ,
263+ ) ,
264+ [ WS_METHODS . serverUpdateServerWithProgress ] : ( ) =>
265+ ( loss === "no_progress"
266+ ? Stream . empty
267+ : Stream . make ( { type : "progress" as const , stage : "downloading" as const } )
268+ ) . pipe (
269+ Stream . concat (
270+ Stream . fromEffect (
271+ loss === "cancel"
272+ ? Effect . fiber . pipe (
273+ Effect . flatMap ( ( fiber ) => Deferred . succeed ( cancelFiber , fiber ) ) ,
274+ Effect . andThen ( Effect . never ) ,
275+ )
276+ : loss === "interrupt"
277+ ? Effect . interrupt
278+ : Effect . fail (
279+ loss === "server_error"
280+ ? new ServerSelfUpdateError ( {
281+ reason : "Archive verification failed." ,
282+ } )
283+ : new RpcClientError . RpcClientError ( {
284+ reason : new Socket . SocketCloseError ( { code : 1006 } ) ,
285+ } ) ,
286+ ) ,
287+ ) ,
288+ ) ,
289+ ) ,
290+ } as unknown as WsRpcProtocolClient ;
291+ const supervisor = EnvironmentSupervisor . EnvironmentSupervisor . of ( {
292+ target : TARGET ,
293+ state : yield * SubscriptionRef . make ( AVAILABLE_CONNECTION_STATE ) ,
294+ session : yield * SubscriptionRef . make ( Option . some ( session ( client ) ) ) ,
295+ prepared : yield * SubscriptionRef . make ( Option . none < PreparedConnection > ( ) ) ,
296+ connect : Effect . void ,
297+ disconnect : Effect . void ,
298+ retryNow : Effect . void ,
299+ } ) ;
300+ const run : EnvironmentRegistry . EnvironmentRegistry [ "Service" ] [ "run" ] = ( _id , effect ) =>
301+ Effect . provideService ( effect , EnvironmentSupervisor . EnvironmentSupervisor , supervisor ) ;
302+ const runStream : EnvironmentRegistry . EnvironmentRegistry [ "Service" ] [ "runStream" ] = (
303+ _id ,
304+ stream ,
305+ ) => Stream . provideService ( stream , EnvironmentSupervisor . EnvironmentSupervisor , supervisor ) ;
306+ const environmentRegistry = EnvironmentRegistry . EnvironmentRegistry . of ( {
307+ run,
308+ runStream,
309+ followStream : runStream ,
310+ stateChanges : ( ) => Stream . never ,
311+ retryNow : ( ) => Effect . void ,
312+ } as unknown as EnvironmentRegistry . EnvironmentRegistry [ "Service" ] ) ;
313+ const runtime = Atom . runtime (
314+ Layer . mergeAll (
315+ Layer . succeed ( EnvironmentRegistry . EnvironmentRegistry , environmentRegistry ) ,
316+ Layer . succeed ( RpcPermissionGuard , { authorize : ( ) => Effect . void } ) ,
317+ Layer . succeed ( Persistence . EnvironmentCacheStore , {
318+ loadServerConfig : ( ) => Effect . succeedNone ,
319+ } as unknown as Persistence . EnvironmentCacheStore [ "Service" ] ) ,
320+ ) ,
321+ ) ;
322+ const atoms = createServerEnvironmentAtoms ( runtime , {
323+ initialConfigValueAtom : ( ) => Atom . make ( config ) ,
324+ } ) ;
325+ const registry = yield * Effect . acquireRelease ( Effect . sync ( AtomRegistry . make ) , ( value ) =>
326+ Effect . sync ( ( ) => value . dispose ( ) ) ,
327+ ) ;
328+ const pending = atoms . updateServer . run ( registry , {
329+ environmentId : TARGET . environmentId ,
330+ input : { targetVersion : "0.0.31" } ,
331+ } ) ;
332+ if ( loss === "cancel" ) {
333+ yield * Fiber . interrupt ( yield * Deferred . await ( cancelFiber ) ) ;
334+ const cancelled = yield * Effect . promise ( ( ) => pending ) ;
335+ expect ( cancelled . _tag ) . toBe ( "Failure" ) ;
336+ if ( cancelled . _tag === "Failure" )
337+ expect ( Cause . hasInterruptsOnly ( cancelled . cause ) ) . toBe ( true ) ;
338+ expect ( registry . get ( serverUpdateStateAtom ( TARGET . environmentId ) ) ) . toEqual ( {
339+ status : "idle" ,
340+ } ) ;
341+ expect ( yield * Deferred . isDone ( observing ) ) . toBe ( false ) ;
342+ return ;
343+ }
344+ const first = yield * Effect . raceFirst (
345+ Effect . promise ( ( ) => pending ) . pipe ( Effect . as ( "settled" ) ) ,
346+ Deferred . await ( observing ) . pipe ( Effect . as ( "observing" ) ) ,
347+ ) ;
348+ if ( ! resumes ) {
349+ expect ( first ) . toBe ( "settled" ) ;
350+ expect ( AsyncResult . isFailure ( yield * Effect . promise ( ( ) => pending ) ) ) . toBe ( true ) ;
351+ expect ( registry . get ( serverUpdateStateAtom ( TARGET . environmentId ) ) ) . toMatchObject ( {
352+ status : "failed" ,
353+ } ) ;
354+ return ;
355+ }
356+ expect ( first ) . toBe ( "observing" ) ;
357+ expect ( registry . get ( serverUpdateStateAtom ( TARGET . environmentId ) ) ) . toMatchObject ( {
358+ status : "running" ,
359+ stage : "resuming" ,
360+ } ) ;
361+ const ready = ( serverVersion : string ) =>
362+ ( {
363+ version : 1 ,
364+ sequence : 1 ,
365+ type : "ready" ,
366+ payload : { at : "2026-09-01T00:00:00.000Z" , environment : { serverVersion } } ,
367+ } ) as Parameters < typeof matchesServerUpdateReadyEvent > [ 1 ] ;
368+ yield * Queue . offer ( readyEvents , ready ( "0.0.30" ) ) ;
369+ yield * Deferred . await ( oldReadyObserved ) ;
370+ expect ( registry . get ( serverUpdateStateAtom ( TARGET . environmentId ) ) ) . toMatchObject ( {
371+ status : "running" ,
372+ } ) ;
373+ yield * Queue . offer ( readyEvents , ready ( "0.0.31" ) ) ;
374+ expect ( AsyncResult . isSuccess ( yield * Effect . promise ( ( ) => pending ) ) ) . toBe ( true ) ;
375+ expect ( registry . get ( serverUpdateStateAtom ( TARGET . environmentId ) ) ) . toEqual ( {
376+ status : "idle" ,
377+ } ) ;
378+ } ) . pipe ( Effect . scoped ) ,
379+ ) ;
380+ } ) ;
381+
219382const makeConfigPersistenceHarness = Effect . fn ( "test.makeConfigPersistenceHarness" ) ( function * (
220383 saveServerConfig : Persistence . EnvironmentCacheStore [ "Service" ] [ "saveServerConfig" ] ,
221384) {
0 commit comments