@livestore/utils-dev 0.4.0-dev.7 → 0.4.0-dev.9

package/dist/wrangler/WranglerDevServer.test.js

@@ -0,0 +1,77 @@
+import { Effect, FetchHttpClient, Layer } from '@livestore/utils/effect';
+import { getFreePort, PlatformNode } from '@livestore/utils/node';
+import { Vitest } from '@livestore/utils-dev/node-vitest';
+import { expect } from 'vitest';
+import { WranglerDevServerError, WranglerDevServerService, } from "./WranglerDevServer.js";
+const testTimeout = 60_000;
+const WranglerDevServerTest = (args = {}) => WranglerDevServerService.Default({
+    cwd: `${import.meta.dirname}/fixtures`,
+    ...args,
+}).pipe(Layer.provide(FetchHttpClient.layer));
+Vitest.describe('WranglerDevServer', { timeout: testTimeout }, () => {
+    Vitest.describe('Basic Operations', () => {
+        const withBasicTest = (args = {}) => Vitest.makeWithTestCtx({
+            timeout: testTimeout,
+            makeLayer: () => WranglerDevServerTest(args).pipe(Layer.provide(PlatformNode.NodeContext.layer)),
+        });
+        Vitest.scopedLive('should start wrangler dev server and return port', (test) => Effect.gen(function* () {
+            const server = yield* WranglerDevServerService;
+            expect(server.port).toBeGreaterThan(0);
+            expect(server.url).toMatch(/http:\/\/127.0.0.1:\d+/);
+        }).pipe(withBasicTest()(test)));
+        Vitest.scopedLive('should use specified port when provided', (test) => Effect.andThen(getFreePort, (port) => Effect.gen(function* () {
+            const server = yield* WranglerDevServerService;
+            expect(server.port).toBe(port);
+            expect(server.url).toBe(`http://127.0.0.1:${port}`);
+        }).pipe(withBasicTest({ preferredPort: port })(test))));
+    });
+    Vitest.describe('Error Handling', () => {
+        const withErrorTest = (args = {}) => Vitest.makeWithTestCtx({
+            timeout: testTimeout,
+            makeLayer: () => WranglerDevServerTest(args).pipe(Layer.provide(PlatformNode.NodeContext.layer)),
+        });
+        Vitest.scopedLive('should handle missing wrangler.toml but should timeout', (test) => Effect.gen(function* () {
+            const error = yield* WranglerDevServerService.pipe(Effect.provide(WranglerDevServerTest({
+                cwd: '/tmp',
+                wranglerConfigPath: '/dev/null',
+                connectTimeout: '500 millis',
+            }).pipe(Layer.provide(PlatformNode.NodeContext.layer))), Effect.flip);
+            expect(error).toBeInstanceOf(WranglerDevServerError);
+        }).pipe(Vitest.withTestCtx(test)));
+        Vitest.scopedLive('should handle invalid working directory', (test) => Effect.gen(function* () {
+            const result = yield* WranglerDevServerService.pipe(Effect.provide(WranglerDevServerTest({
+                cwd: '/completely/nonexistent/directory',
+            }).pipe(Layer.provide(PlatformNode.NodeContext.layer))), Effect.either);
+            expect(result._tag).toBe('Left');
+            if (result._tag === 'Left') {
+                expect(result.left).toBeInstanceOf(WranglerDevServerError);
+            }
+        }).pipe(Vitest.withTestCtx(test)));
+        Vitest.scopedLive('should timeout if server fails to start', (test) => Effect.gen(function* () {
+            // Create a command that will never output "Ready on"
+            const result = yield* WranglerDevServerService.pipe(
+            // Override the timeout for this test to be shorter
+            Effect.timeout('5 seconds'), Effect.either);
+            // This might succeed or fail depending on actual wrangler behavior
+            // The main point is testing timeout functionality
+            expect(['Left', 'Right']).toContain(result._tag);
+        }).pipe(withErrorTest()(test)));
+    });
+    Vitest.describe('Service Pattern', () => {
+        const withServiceTest = (args = {}) => Vitest.makeWithTestCtx({
+            timeout: testTimeout,
+            makeLayer: () => WranglerDevServerTest(args).pipe(Layer.provide(PlatformNode.NodeContext.layer)),
+        });
+        Vitest.scopedLive('should work with service pattern', (test) => Effect.gen(function* () {
+            const server = yield* WranglerDevServerService;
+            expect(server.port).toBeGreaterThan(0);
+            expect(server.url).toMatch(/http:\/\/127.0.0.1:\d+/);
+        }).pipe(withServiceTest()(test)));
+        Vitest.scopedLive('should work with custom port via service', (test) => Effect.andThen(getFreePort, (port) => Effect.gen(function* () {
+            const server = yield* WranglerDevServerService;
+            expect(server.port).toBe(port);
+            expect(server.url).toBe(`http://127.0.0.1:${port}`);
+        }).pipe(withServiceTest({ preferredPort: port })(test))));
+    });
+});
+//# sourceMappingURL=WranglerDevServer.test.js.map

package/dist/wrangler/WranglerDevServer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WranglerDevServer.test.js","sourceRoot":"","sources":["../../src/wrangler/WranglerDevServer.test.ts"],"names":[],"mappings":"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"}

package/dist/wrangler/fixtures/cf-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cf-worker.d.ts","sourceRoot":"","sources":["../../../src/wrangler/fixtures/cf-worker.ts"],"names":[],"mappings":";oBACwB,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;;AADnD,wBAIC;AAED,qBAAa,MAAM;IACX,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;CAGlD"}

package/dist/wrangler/fixtures/cf-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cf-worker.js","sourceRoot":"","sources":["../../../src/wrangler/fixtures/cf-worker.ts"],"names":[],"mappings":"AAAA,eAAe;IACb,KAAK,CAAC,KAAK,CAAC,QAAiB;QAC3B,OAAO,IAAI,QAAQ,CAAC,6CAA6C,CAAC,CAAA;IACpE,CAAC;CACF,CAAA;AAED,MAAM,OAAO,MAAM;IACjB,KAAK,CAAC,KAAK,CAAC,QAAiB;QAC3B,OAAO,IAAI,QAAQ,CAAC,iCAAiC,CAAC,CAAA;IACxD,CAAC;CACF"}

package/dist/wrangler/mod.d.ts

@@ -0,0 +1,2 @@
+export { type StartWranglerDevServerArgs, type WranglerDevServer, WranglerDevServerError, WranglerDevServerService, } from './WranglerDevServer.ts';
+//# sourceMappingURL=mod.d.ts.map

package/dist/wrangler/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/wrangler/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,wBAAwB,CAAA"}

package/dist/wrangler/mod.js

@@ -0,0 +1,2 @@
+export { WranglerDevServerError, WranglerDevServerService, } from "./WranglerDevServer.js";
+//# sourceMappingURL=mod.js.map

package/dist/wrangler/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../src/wrangler/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,wBAAwB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livestore/utils-dev",
-  "version": "0.4.0-dev.7",
+  "version": "0.4.0-dev.9",
   "type": "module",
   "sideEffects": [
     "./src/node-vitest/global.ts",
@@ -8,18 +8,21 @@
   ],
   "exports": {
     "./node": "./dist/node/mod.js",
-    "./node-vitest": "./dist/node-vitest/mod.js"
+    "./node-vitest": "./dist/node-vitest/mod.js",
+    "./wrangler": "./dist/wrangler/mod.js"
   },
   "dependencies": {
-    "@effect/opentelemetry": "0.56.4",
+    "@effect/opentelemetry": "0.57.0",
     "@effect/vitest": "0.25.1",
+    "@iarna/toml": "2.2.5",
     "@opentelemetry/api": "1.9.0",
     "@opentelemetry/exporter-metrics-otlp-http": "0.203.0",
     "@opentelemetry/exporter-trace-otlp-http": "0.203.0",
     "@opentelemetry/sdk-metrics": "2.0.1",
     "@opentelemetry/sdk-trace-base": "2.0.1",
     "@opentelemetry/sdk-trace-node": "2.0.1",
-    "@livestore/utils": "0.4.0-dev.7"
+    "wrangler": "4.38.0",
+    "@livestore/utils": "0.4.0-dev.9"
   },
   "devDependencies": {},
   "files": [

package/src/node/DockerComposeService/DockerComposeService.ts

@@ -4,6 +4,7 @@ import {
   type CommandExecutor,
   Duration,
   Effect,
+  Fiber,
   type PlatformError,
   Schedule,
   Schema,
@@ -13,7 +14,7 @@ import {
 
 export class DockerComposeError extends Schema.TaggedError<DockerComposeError>()('DockerComposeError', {
   cause: Schema.Defect,
-  message: Schema.String,
+  note: Schema.String,
 }) {}
 
 export interface DockerComposeArgs {
@@ -43,6 +44,11 @@ export interface DockerComposeOperations {
     options?: StartOptions,
   ) => Effect.Effect<void, DockerComposeError | PlatformError.PlatformError, Scope.Scope>
   readonly stop: Effect.Effect<void, DockerComposeError | PlatformError.PlatformError>
+  readonly down: (options?: {
+    readonly env?: Record<string, string>
+    readonly volumes?: boolean
+    readonly removeOrphans?: boolean
+  }) => Effect.Effect<void, DockerComposeError | PlatformError.PlatformError>
   readonly logs: (
     options?: LogsOptions,
   ) => Stream.Stream<string, DockerComposeError | PlatformError.PlatformError, Scope.Scope>
@@ -58,24 +64,59 @@ export class DockerComposeService extends Effect.Service<DockerComposeService>()
       const pull = Effect.gen(function* () {
         yield* Effect.log(`Pulling Docker Compose images in ${cwd}`)
 
-        yield* Command.make('docker', 'compose', 'pull').pipe(
+        // TODO (@IMax153) Refactor the effect command related code below as there is probably a much more elegant way to accomplish what we want here in a more effect idiomatic way.
+        const pullCommand = Command.make('docker', 'compose', 'pull').pipe(
           Command.workingDirectory(cwd),
-          Command.exitCode,
-          Effect.flatMap((exitCode: number) =>
-            exitCode === 0
-              ? Effect.void
-              : Effect.fail(
-                  new DockerComposeError({
-                    cause: new Error(`Docker compose pull failed with exit code ${exitCode}`),
-                    message: `Docker compose pull failed with exit code ${exitCode}`,
-                  }),
-                ),
-          ),
-          Effect.provide(commandExecutorContext),
+          Command.stdout('pipe'),
+          Command.stderr('pipe'),
         )
 
+        const process = yield* pullCommand.pipe(Command.start, Effect.provide(commandExecutorContext))
+
+        const stdoutFiber = yield* process.stdout.pipe(
+          Stream.decodeText('utf8'),
+          Stream.runFold('', (acc, chunk) => acc + chunk),
+          Effect.fork,
+        )
+
+        const stderrFiber = yield* process.stderr.pipe(
+          Stream.decodeText('utf8'),
+          Stream.runFold('', (acc, chunk) => acc + chunk),
+          Effect.fork,
+        )
+
+        const exitCode = yield* process.exitCode
+        const stdout = yield* Fiber.join(stdoutFiber)
+        const stderr = yield* Fiber.join(stderrFiber)
+
+        const exitCodeNumber = Number(exitCode)
+
+        if (exitCodeNumber !== 0) {
+          const stdoutLog = stdout.length > 0 ? stdout : '<empty stdout>'
+          const stderrLog = stderr.length > 0 ? stderr : '<empty stderr>'
+          const failureMessage = [
+            `Docker compose pull failed with exit code ${exitCodeNumber} in ${cwd}`,
+            `stdout:\n${stdoutLog}`,
+            `stderr:\n${stderrLog}`,
+          ].join('\n')
+
+          yield* Effect.logError(failureMessage)
+
+          return yield* new DockerComposeError({
+            cause: new Error(`Docker compose pull failed with exit code ${exitCodeNumber}`),
+            note: failureMessage,
+          })
+        }
+
         yield* Effect.log(`Successfully pulled Docker Compose images`)
-      }).pipe(Effect.withSpan('pullDockerComposeImages'))
+      }).pipe(
+        Effect.retry({
+          schedule: Schedule.exponentialBackoff10Sec,
+          while: Schema.is(DockerComposeError),
+        }),
+        Effect.withSpan('pullDockerComposeImages'),
+        Effect.scoped,
+      )
 
       const start = (options: StartOptions = {}) =>
         Effect.gen(function* () {
@@ -89,12 +130,14 @@ export class DockerComposeService extends Effect.Service<DockerComposeService>()
           const command = yield* Command.make(baseArgs[0]!, ...baseArgs.slice(1)).pipe(
             Command.workingDirectory(cwd),
             Command.env(options.env ?? {}),
+            Command.stderr('inherit'),
+            Command.stdout('inherit'),
             Command.start,
             Effect.catchAll((cause) =>
               Effect.fail(
                 new DockerComposeError({
                   cause,
-                  message: `Failed to start Docker Compose services in ${cwd}`,
+                  note: `Failed to start Docker Compose services in ${cwd}`,
                 }),
               ),
             ),
@@ -103,13 +146,13 @@ export class DockerComposeService extends Effect.Service<DockerComposeService>()
 
           // Wait for command completion
           yield* command.exitCode.pipe(
-            Effect.flatMap((exitCode: number) =>
+            Effect.flatMap((exitCode) =>
               exitCode === 0
                 ? Effect.void
                 : Effect.fail(
                     new DockerComposeError({
                       cause: new Error(`Docker compose exited with code ${exitCode}`),
-                      message: `Docker Compose failed to start with exit code ${exitCode}`,
+                      note: `Docker Compose failed to start with exit code ${exitCode}. Env: ${JSON.stringify(options.env)}`,
                     }),
                   ),
             ),
@@ -140,7 +183,7 @@ export class DockerComposeService extends Effect.Service<DockerComposeService>()
               : Effect.fail(
                   new DockerComposeError({
                     cause: new Error(`Docker compose stop exited with code ${exitCode}`),
-                    message: `Failed to stop Docker Compose services`,
+                    note: `Failed to stop Docker Compose services`,
                   }),
                 ),
           ),
@@ -167,7 +210,7 @@ export class DockerComposeService extends Effect.Service<DockerComposeService>()
               Effect.fail(
                 new DockerComposeError({
                   cause,
-                  message: `Failed to read Docker Compose logs in ${cwd}`,
+                  note: `Failed to read Docker Compose logs in ${cwd}`,
                 }),
               ),
             ),
@@ -181,13 +224,46 @@ export class DockerComposeService extends Effect.Service<DockerComposeService>()
               (cause) =>
                 new DockerComposeError({
                   cause,
-                  message: `Error reading Docker Compose logs in ${cwd}`,
+                  note: `Error reading Docker Compose logs in ${cwd}`,
                 }),
             ),
           )
         }).pipe(Stream.unwrapScoped)
 
-      return { pull, start, stop, logs }
+      const down = (options?: {
+        readonly env?: Record<string, string>
+        readonly volumes?: boolean
+        readonly removeOrphans?: boolean
+      }) =>
+        Effect.gen(function* () {
+          yield* Effect.log(`Tearing down Docker Compose services in ${cwd}`)
+
+          const baseArgs = ['docker', 'compose', 'down']
+          if (options?.volumes) baseArgs.push('-v')
+          if (options?.removeOrphans) baseArgs.push('--remove-orphans')
+          if (serviceName) baseArgs.push(serviceName)
+
+          yield* Command.make(baseArgs[0]!, ...baseArgs.slice(1)).pipe(
+            Command.workingDirectory(cwd),
+            Command.env(options?.env ?? {}),
+            Command.exitCode,
+            Effect.flatMap((exitCode: number) =>
+              exitCode === 0
+                ? Effect.void
+                : Effect.fail(
+                    new DockerComposeError({
+                      cause: new Error(`Docker compose down exited with code ${exitCode}`),
+                      note: `Failed to tear down Docker Compose services`,
+                    }),
+                  ),
+            ),
+            Effect.provide(commandExecutorContext),
+          )
+
+          yield* Effect.log(`Docker Compose services torn down successfully`)
+        }).pipe(Effect.withSpan('downDockerCompose'))
+
+      return { pull, start, stop, down, logs }
     }),
 }) {}
 
@@ -219,7 +295,7 @@ const performHealthCheck = ({
         Effect.fail(
           new DockerComposeError({
             cause: new Error('Health check timeout'),
-            message: `Health check failed for ${url} after ${Duration.toMillis(timeout)}ms`,
+            note: `Health check failed for ${url} after ${Duration.toMillis(timeout)}ms`,
           }),
         ),
       ),

package/src/node/mod.ts

@@ -24,13 +24,6 @@ export {
   startDockerComposeServicesScoped,
 } from './DockerComposeService/DockerComposeService.ts'
 export * as FileLogger from './FileLogger.ts'
-export * from './WranglerDevServer/process-tree-manager.ts'
-export {
-  type StartWranglerDevServerArgs,
-  type WranglerDevServer,
-  WranglerDevServerError,
-  WranglerDevServerService,
-} from './WranglerDevServer/WranglerDevServer.ts'
 
 export const OtelLiveHttp = ({
   serviceName,

package/src/node-vitest/Vitest.test.ts

@@ -96,6 +96,17 @@ Vitest.describe('Vitest.asProp', () => {
 
         return
       }),
-    { fastCheck: { numRuns: 5, endOnFailure: true }, fails: true },
+    {
+      fastCheck: {
+        numRuns: 5,
+        endOnFailure: true,
+        // Provide explicit samples so the second run crosses >50. Randomly drawing five
+        // integers has ~3% chance to stay ≤ 50, which would break the `fails: true`
+        // expectation even though shrinking remains disabled. The examples keep the
+        // demo readable while leaving the remaining runs to FastCheck.
+        examples: [[5], [66]],
+      },
+      fails: true,
+    },
   )
 })

package/src/node-vitest/Vitest.ts

@@ -20,25 +20,29 @@ export * from '@effect/vitest'
 
 export const DEBUGGER_ACTIVE = Boolean(process.env.DEBUGGER_ACTIVE ?? inspector.url() !== undefined)
 
-export const makeWithTestCtx: <R1, E1>(
-  ctxParams: WithTestCtxParams<R1, E1>,
-) => (
-  testContext: Vitest.TestContext,
-) => <A, E>(
-  self: Effect.Effect<A, E, Scope.Scope | NoInfer<R1> | OtelTracer.OtelTracer>,
-) => Effect.Effect<A, E1 | Cause.TimeoutException | E, Scope.Scope> =
-  (ctxParams) => (testContext: Vitest.TestContext) =>
-    withTestCtx(testContext, ctxParams)
-
-export type WithTestCtxParams<R1, E1> = {
+export const makeWithTestCtx: <ROut = never, E1 = never, RIn = never>(
+  ctxParams: WithTestCtxParams<ROut, E1, RIn>,
+) => (testContext: Vitest.TestContext) => <A, E, R>(
+  self: Effect.Effect<A, E, R>,
+) => Effect.Effect<
+  A,
+  E | E1 | Cause.TimeoutException,
+  // Exclude dependencies provided by `withTestCtx` from the layer dependencies
+  | Exclude<RIn, OtelTracer.OtelTracer | Scope.Scope>
+  // Exclude dependencies provided by `withTestCtx` **and** dependencies produced
+  // by the layer from the effect dependencies
+  | Exclude<R, ROut | OtelTracer.OtelTracer | Scope.Scope>
+> = (ctxParams) => (testContext: Vitest.TestContext) => withTestCtx(testContext, ctxParams)
+
+export type WithTestCtxParams<ROut, E1, RIn> = {
   suffix?: string
-  makeLayer?: (testContext: Vitest.TestContext) => Layer.Layer<R1, E1, Scope.Scope>
+  makeLayer?: (testContext: Vitest.TestContext) => Layer.Layer<ROut, E1, RIn | Scope.Scope>
   timeout?: Duration.DurationInput
   forceOtel?: boolean
 }
 
 export const withTestCtx =
-  <R1 = never, E1 = never>(
+  <ROut = never, E1 = never, RIn = never>(
     testContext: Vitest.TestContext,
     {
       suffix,
@@ -47,23 +51,31 @@ export const withTestCtx =
       forceOtel = false,
     }: {
       suffix?: string
-      makeLayer?: (testContext: Vitest.TestContext) => Layer.Layer<R1, E1, Scope.Scope>
+      makeLayer?: (testContext: Vitest.TestContext) => Layer.Layer<ROut, E1, RIn>
       timeout?: Duration.DurationInput
       forceOtel?: boolean
     } = {},
   ) =>
-  <A, E>(
-    self: Effect.Effect<A, E, Scope.Scope | OtelTracer.OtelTracer | R1>,
-  ): Effect.Effect<A, E | Cause.TimeoutException | E1, Scope.Scope> => {
+  <A, E, R>(
+    self: Effect.Effect<A, E, R>,
+  ): Effect.Effect<
+    A,
+    E | E1 | Cause.TimeoutException,
+    // Exclude dependencies provided internally from the provided layer's dependencies
+    | Exclude<RIn, OtelTracer.OtelTracer | Scope.Scope>
+    // Exclude dependencies provided internally **and** dependencies produced by the
+    // provided layer from the effect dependencies
+    | Exclude<R, ROut | OtelTracer.OtelTracer | Scope.Scope>
+  > => {
     const spanName = `${testContext.task.suite?.name}:${testContext.task.name}${suffix ? `:${suffix}` : ''}`
-    const layer = makeLayer?.(testContext)
+    const layer = makeLayer?.(testContext) ?? Layer.empty
 
     const otelLayer =
       DEBUGGER_ACTIVE || forceOtel
         ? OtelLiveHttp({ rootSpanName: spanName, serviceName: 'vitest-runner', skipLogUrl: false })
         : OtelLiveDummy
 
-    const combinedLayer = (layer ?? Layer.empty).pipe(Layer.provideMerge(otelLayer))
+    const combinedLayer = layer.pipe(Layer.provideMerge(otelLayer))
 
     return self.pipe(
       DEBUGGER_ACTIVE

package/src/wrangler/WranglerDevServer.test.ts

@@ -0,0 +1,133 @@
+import { Effect, FetchHttpClient, Layer } from '@livestore/utils/effect'
+import { getFreePort, PlatformNode } from '@livestore/utils/node'
+import { Vitest } from '@livestore/utils-dev/node-vitest'
+import { expect } from 'vitest'
+import {
+  type StartWranglerDevServerArgs,
+  WranglerDevServerError,
+  WranglerDevServerService,
+} from './WranglerDevServer.ts'
+
+const testTimeout = 60_000
+
+const WranglerDevServerTest = (args: Partial<StartWranglerDevServerArgs> = {}) =>
+  WranglerDevServerService.Default({
+    cwd: `${import.meta.dirname}/fixtures`,
+    ...args,
+  }).pipe(Layer.provide(FetchHttpClient.layer))
+
+Vitest.describe('WranglerDevServer', { timeout: testTimeout }, () => {
+  Vitest.describe('Basic Operations', () => {
+    const withBasicTest = (args: Partial<StartWranglerDevServerArgs> = {}) =>
+      Vitest.makeWithTestCtx({
+        timeout: testTimeout,
+        makeLayer: () => WranglerDevServerTest(args).pipe(Layer.provide(PlatformNode.NodeContext.layer)),
+      })
+
+    Vitest.scopedLive('should start wrangler dev server and return port', (test) =>
+      Effect.gen(function* () {
+        const server = yield* WranglerDevServerService
+
+        expect(server.port).toBeGreaterThan(0)
+        expect(server.url).toMatch(/http:\/\/127.0.0.1:\d+/)
+      }).pipe(withBasicTest()(test)),
+    )
+
+    Vitest.scopedLive('should use specified port when provided', (test) =>
+      Effect.andThen(getFreePort, (port) =>
+        Effect.gen(function* () {
+          const server = yield* WranglerDevServerService
+
+          expect(server.port).toBe(port)
+          expect(server.url).toBe(`http://127.0.0.1:${port}`)
+        }).pipe(withBasicTest({ preferredPort: port })(test)),
+      ),
+    )
+  })
+
+  Vitest.describe('Error Handling', () => {
+    const withErrorTest = (args: Partial<StartWranglerDevServerArgs> = {}) =>
+      Vitest.makeWithTestCtx({
+        timeout: testTimeout,
+        makeLayer: () => WranglerDevServerTest(args).pipe(Layer.provide(PlatformNode.NodeContext.layer)),
+      })
+
+    Vitest.scopedLive('should handle missing wrangler.toml but should timeout', (test) =>
+      Effect.gen(function* () {
+        const error = yield* WranglerDevServerService.pipe(
+          Effect.provide(
+            WranglerDevServerTest({
+              cwd: '/tmp',
+              wranglerConfigPath: '/dev/null',
+              connectTimeout: '500 millis',
+            }).pipe(Layer.provide(PlatformNode.NodeContext.layer)),
+          ),
+          Effect.flip,
+        )
+
+        expect(error).toBeInstanceOf(WranglerDevServerError)
+      }).pipe(Vitest.withTestCtx(test)),
+    )
+
+    Vitest.scopedLive('should handle invalid working directory', (test) =>
+      Effect.gen(function* () {
+        const result = yield* WranglerDevServerService.pipe(
+          Effect.provide(
+            WranglerDevServerTest({
+              cwd: '/completely/nonexistent/directory',
+            }).pipe(Layer.provide(PlatformNode.NodeContext.layer)),
+          ),
+          Effect.either,
+        )
+
+        expect(result._tag).toBe('Left')
+        if (result._tag === 'Left') {
+          expect(result.left).toBeInstanceOf(WranglerDevServerError)
+        }
+      }).pipe(Vitest.withTestCtx(test)),
+    )
+
+    Vitest.scopedLive('should timeout if server fails to start', (test) =>
+      Effect.gen(function* () {
+        // Create a command that will never output "Ready on"
+        const result = yield* WranglerDevServerService.pipe(
+          // Override the timeout for this test to be shorter
+          Effect.timeout('5 seconds'),
+          Effect.either,
+        )
+
+        // This might succeed or fail depending on actual wrangler behavior
+        // The main point is testing timeout functionality
+        expect(['Left', 'Right']).toContain(result._tag)
+      }).pipe(withErrorTest()(test)),
+    )
+  })
+
+  Vitest.describe('Service Pattern', () => {
+    const withServiceTest = (args: Partial<StartWranglerDevServerArgs> = {}) =>
+      Vitest.makeWithTestCtx({
+        timeout: testTimeout,
+        makeLayer: () => WranglerDevServerTest(args).pipe(Layer.provide(PlatformNode.NodeContext.layer)),
+      })
+
+    Vitest.scopedLive('should work with service pattern', (test) =>
+      Effect.gen(function* () {
+        const server = yield* WranglerDevServerService
+
+        expect(server.port).toBeGreaterThan(0)
+        expect(server.url).toMatch(/http:\/\/127.0.0.1:\d+/)
+      }).pipe(withServiceTest()(test)),
+    )
+
+    Vitest.scopedLive('should work with custom port via service', (test) =>
+      Effect.andThen(getFreePort, (port) =>
+        Effect.gen(function* () {
+          const server = yield* WranglerDevServerService
+
+          expect(server.port).toBe(port)
+          expect(server.url).toBe(`http://127.0.0.1:${port}`)
+        }).pipe(withServiceTest({ preferredPort: port })(test)),
+      ),
+    )
+  })
+})