@livestore/utils-dev 0.4.0-dev.2 → 0.4.0-dev.20

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',
+                readiness: { 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

@@ -0,0 +1,8 @@
+declare const _default: {
+    fetch(_request: Request): Promise<Response>;
+};
+export default _default;
+export declare class TestDO {
+    fetch(_request: Request): Promise<Response>;
+}
+//# sourceMappingURL=cf-worker.d.ts.map

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

@@ -0,0 +1,11 @@
+export default {
+    async fetch(_request) {
+        return new Response('Hello from Wrangler Dev Server test worker!');
+    },
+};
+export class TestDO {
+    async fetch(_request) {
+        return new Response('Hello from Test Durable Object!');
+    }
+}
+//# sourceMappingURL=cf-worker.js.map

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,24 +1,28 @@
 {
   "name": "@livestore/utils-dev",
-  "version": "0.4.0-dev.2",
+  "version": "0.4.0-dev.20",
   "type": "module",
   "sideEffects": [
-    "./src/node-vitest/polyfill.ts"
+    "./src/node-vitest/global.ts",
+    "./dist/node-vitest/global.js"
   ],
   "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.1",
-    "@effect/vitest": "0.25.0",
+    "@effect/opentelemetry": "0.58.0",
+    "@effect/vitest": "0.26.0",
+    "@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.2"
+    "wrangler": "4.42.2",
+    "@livestore/utils": "0.4.0-dev.20"
   },
   "devDependencies": {},
   "files": [
@@ -29,10 +33,7 @@
   "license": "Apache-2.0",
   "peerDependencies": {},
   "publishConfig": {
-    "access": "public",
-    "sideEffects": [
-      "./dist/node-vitest/polyfill.js"
-    ]
+    "access": "public"
   },
   "scripts": {
     "test": "echo 'No tests for utils-dev'"

package/src/node/DockerComposeService/DockerComposeService.test.ts

@@ -0,0 +1,91 @@
+import path from 'node:path'
+import { Duration, Effect, Layer, Stream } from '@livestore/utils/effect'
+import { PlatformNode } from '@livestore/utils/node'
+import { Vitest } from '@livestore/utils-dev/node-vitest'
+import { expect } from 'vitest'
+import { type DockerComposeArgs, DockerComposeService } from './DockerComposeService.ts'
+
+const testTimeout = 30_000
+const testFixturePath = path.join(import.meta.dirname, 'test-fixtures')
+
+const DockerComposeTest = (args: Partial<DockerComposeArgs> = {}) =>
+  DockerComposeService.Default({
+    cwd: testFixturePath,
+    ...args,
+  })
+
+Vitest.describe('DockerComposeService', { timeout: testTimeout }, () => {
+  Vitest.describe('Basic Operations', () => {
+    const withBasicTest = (args: Partial<DockerComposeArgs> = {}) =>
+      Vitest.makeWithTestCtx({
+        timeout: testTimeout,
+        makeLayer: () => DockerComposeTest(args).pipe(Layer.provide(PlatformNode.NodeContext.layer)),
+      })
+
+    Vitest.scopedLive('can pull docker images', (test) =>
+      Effect.gen(function* () {
+        const dockerCompose = yield* DockerComposeService
+
+        // Test that pull operation works (should succeed for hello-world image)
+        yield* dockerCompose.pull
+      }).pipe(withBasicTest()(test)),
+    )
+
+    Vitest.scopedLive('can start and stop docker compose services', (test) =>
+      Effect.gen(function* () {
+        const dockerCompose = yield* DockerComposeService
+
+        // Start the service
+        yield* dockerCompose.start({ detached: true })
+
+        // Stop the service
+        yield* dockerCompose.stop
+      }).pipe(withBasicTest({ serviceName: 'hello-world' })(test)),
+    )
+
+    Vitest.scopedLive('can get logs from docker compose services', (test) =>
+      Effect.gen(function* () {
+        const dockerCompose = yield* DockerComposeService
+
+        // Start the service first
+        yield* dockerCompose.start({ detached: true })
+
+        // Get logs (should contain at least the "Hello from Docker!" message)
+        const firstLogLine = yield* dockerCompose.logs().pipe(Stream.runHead)
+
+        expect(firstLogLine._tag).toBe('Some')
+
+        // Stop the service
+        yield* dockerCompose.stop
+      }).pipe(withBasicTest({ serviceName: 'hello-world' })(test)),
+    )
+  })
+
+  Vitest.describe('Health Check Operations', () => {
+    const withHealthCheckTest = (args: Partial<DockerComposeArgs> = {}) =>
+      Vitest.makeWithTestCtx({
+        timeout: testTimeout,
+        makeLayer: () => DockerComposeTest(args).pipe(Layer.provide(PlatformNode.NodeContext.layer)),
+      })
+
+    Vitest.scopedLive('handles health check timeout gracefully', (test) =>
+      Effect.gen(function* () {
+        const dockerCompose = yield* DockerComposeService
+
+        // Test starting with a health check that will timeout (invalid URL)
+        const result = yield* dockerCompose
+          .start({
+            detached: true,
+            healthCheck: {
+              url: 'http://localhost:99999/nonexistent',
+              timeout: Duration.seconds(2),
+            },
+          })
+          .pipe(Effect.either)
+
+        // Should fail due to health check timeout
+        expect(result._tag).toBe('Left')
+      }).pipe(withHealthCheckTest({ serviceName: 'hello-world' })(test)),
+    )
+  })
+})

package/src/node/DockerComposeService/DockerComposeService.ts

@@ -0,0 +1,328 @@
+import { omitUndefineds } from '@livestore/utils'
+import {
+  Command,
+  type CommandExecutor,
+  Duration,
+  Effect,
+  Fiber,
+  type PlatformError,
+  Schedule,
+  Schema,
+  type Scope,
+  Stream,
+} from '@livestore/utils/effect'
+
+export class DockerComposeError extends Schema.TaggedError<DockerComposeError>()('DockerComposeError', {
+  cause: Schema.Defect,
+  note: Schema.String,
+}) {}
+
+export interface DockerComposeArgs {
+  readonly cwd: string
+  readonly serviceName?: string
+}
+
+export interface StartOptions {
+  readonly detached?: boolean
+  readonly env?: Record<string, string>
+  readonly healthCheck?: {
+    readonly url: string
+    readonly timeout?: Duration.Duration
+    readonly interval?: Duration.Duration
+  }
+}
+
+export interface LogsOptions {
+  readonly follow?: boolean
+  readonly tail?: number
+  readonly since?: string
+}
+
+export interface DockerComposeOperations {
+  readonly pull: Effect.Effect<void, DockerComposeError | PlatformError.PlatformError>
+  readonly start: (
+    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>
+}
+
+export class DockerComposeService extends Effect.Service<DockerComposeService>()('DockerComposeService', {
+  scoped: (args: DockerComposeArgs) =>
+    Effect.gen(function* () {
+      const { cwd, serviceName } = args
+
+      const commandExecutorContext = yield* Effect.context<CommandExecutor.CommandExecutor>()
+
+      const pull = Effect.gen(function* () {
+        yield* Effect.log(`Pulling Docker Compose images in ${cwd}`)
+
+        // 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.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.retry({
+          schedule: Schedule.exponentialBackoff10Sec,
+          while: Schema.is(DockerComposeError),
+        }),
+        Effect.withSpan('pullDockerComposeImages'),
+        Effect.scoped,
+      )
+
+      const start = (options: StartOptions = {}) =>
+        Effect.gen(function* () {
+          const { detached = true, healthCheck } = options
+
+          // Build start command
+          const baseArgs = ['docker', 'compose', 'up']
+          if (detached) baseArgs.push('-d')
+          if (serviceName) baseArgs.push(serviceName)
+
+          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,
+                  note: `Failed to start Docker Compose services in ${cwd}`,
+                }),
+              ),
+            ),
+            Effect.provide(commandExecutorContext),
+          )
+
+          // Wait for command completion
+          yield* command.exitCode.pipe(
+            Effect.flatMap((exitCode) =>
+              exitCode === 0
+                ? Effect.void
+                : Effect.fail(
+                    new DockerComposeError({
+                      cause: new Error(`Docker compose exited with code ${exitCode}`),
+                      note: `Docker Compose failed to start with exit code ${exitCode}. Env: ${JSON.stringify(options.env)}`,
+                    }),
+                  ),
+            ),
+            Effect.provide(commandExecutorContext),
+          )
+
+          // Perform health check if requested
+          if (healthCheck) {
+            yield* performHealthCheck(healthCheck).pipe(Effect.provide(commandExecutorContext))
+          }
+
+          yield* Effect.log(`Docker Compose services started successfully in ${cwd}`)
+        }).pipe(Effect.withSpan('startDockerCompose'))
+
+      const stop = Effect.gen(function* () {
+        yield* Effect.log(`Stopping Docker Compose services in ${cwd}`)
+
+        const stopCommand = serviceName
+          ? Command.make('docker', 'compose', 'stop', serviceName)
+          : Command.make('docker', 'compose', 'stop')
+
+        yield* stopCommand.pipe(
+          Command.workingDirectory(cwd),
+          Command.exitCode,
+          Effect.flatMap((exitCode: number) =>
+            exitCode === 0
+              ? Effect.void
+              : Effect.fail(
+                  new DockerComposeError({
+                    cause: new Error(`Docker compose stop exited with code ${exitCode}`),
+                    note: `Failed to stop Docker Compose services`,
+                  }),
+                ),
+          ),
+          Effect.provide(commandExecutorContext),
+        )
+
+        yield* Effect.log(`Docker Compose services stopped successfully`)
+      }).pipe(Effect.withSpan('stopDockerCompose'))
+
+      const logs = (options: LogsOptions = {}) =>
+        Effect.gen(function* () {
+          const { follow = false, tail, since } = options
+
+          const baseArgs = ['docker', 'compose', 'logs']
+          if (follow) baseArgs.push('-f')
+          if (tail) baseArgs.push('--tail', tail.toString())
+          if (since) baseArgs.push('--since', since)
+          if (serviceName) baseArgs.push(serviceName)
+
+          const command = yield* Command.make(baseArgs[0]!, ...baseArgs.slice(1)).pipe(
+            Command.workingDirectory(cwd),
+            Command.start,
+            Effect.catchAll((cause) =>
+              Effect.fail(
+                new DockerComposeError({
+                  cause,
+                  note: `Failed to read Docker Compose logs in ${cwd}`,
+                }),
+              ),
+            ),
+            Effect.provide(commandExecutorContext),
+          )
+
+          return command.stdout.pipe(
+            Stream.decodeText('utf8'),
+            Stream.splitLines,
+            Stream.mapError(
+              (cause) =>
+                new DockerComposeError({
+                  cause,
+                  note: `Error reading Docker Compose logs in ${cwd}`,
+                }),
+            ),
+          )
+        }).pipe(Stream.unwrapScoped)
+
+      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 }
+    }),
+}) {}
+
+const performHealthCheck = ({
+  url,
+  timeout = Duration.minutes(2),
+  interval = Duration.seconds(2),
+}: {
+  url: string
+  timeout?: Duration.Duration
+  interval?: Duration.Duration
+}): Effect.Effect<void, DockerComposeError, CommandExecutor.CommandExecutor | Scope.Scope> =>
+  Effect.gen(function* () {
+    yield* Effect.log(`Performing health check on ${url}`)
+
+    const checkHealth = Command.make('curl', '-f', '-s', url).pipe(
+      Command.exitCode,
+      Effect.map((code: number) => code === 0),
+      Effect.catchAll(() => Effect.succeed(false)),
+    )
+
+    const healthCheck = checkHealth.pipe(
+      Effect.repeat({
+        while: (healthy: boolean) => !healthy,
+        schedule: Schedule.fixed(interval),
+      }),
+      Effect.timeout(timeout),
+      Effect.catchAll(() =>
+        Effect.fail(
+          new DockerComposeError({
+            cause: new Error('Health check timeout'),
+            note: `Health check failed for ${url} after ${Duration.toMillis(timeout)}ms`,
+          }),
+        ),
+      ),
+    )
+
+    yield* healthCheck
+    yield* Effect.log(`Health check passed for ${url}`)
+  })
+
+// Convenience function for scoped Docker Compose operations with automatic cleanup
+export const startDockerComposeServicesScoped = (
+  args: DockerComposeArgs & {
+    healthCheck?: StartOptions['healthCheck']
+  },
+): Effect.Effect<
+  void,
+  DockerComposeError | PlatformError.PlatformError,
+  DockerComposeService | CommandExecutor.CommandExecutor | Scope.Scope
+> =>
+  Effect.gen(function* () {
+    const dockerCompose = yield* DockerComposeService
+
+    // Start the services
+    yield* dockerCompose.start({
+      ...omitUndefineds({ healthCheck: args.healthCheck ? args.healthCheck : undefined }),
+    })
+
+    // Add cleanup finalizer to the current scope
+    yield* Effect.addFinalizer(() => dockerCompose.stop.pipe(Effect.orDie))
+  })

package/src/node/DockerComposeService/test-fixtures/docker-compose.yml

@@ -0,0 +1,4 @@
+services:
+  hello-world:
+    image: hello-world
+    profiles: [manual] # Don't auto-start this service