@docker-harpoon/core 0.1.0 → 0.1.3

package/dist/__tests__/bindings.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bindings Integration Tests
+ *
+ * Dogfoods the binding system to verify:
+ * - createEnvBinding helper
+ * - Env var injection into containers
+ * - Binding composition
+ */
+export {};
+//# sourceMappingURL=bindings.test.d.ts.map

package/dist/__tests__/bindings.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/bindings.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/bindings.test.js

@@ -0,0 +1,124 @@
+/**
+ * Bindings Integration Tests
+ *
+ * Dogfoods the binding system to verify:
+ * - createEnvBinding helper
+ * - Env var injection into containers
+ * - Binding composition
+ */
+import { describe, test, expect, afterEach, setDefaultTimeout } from 'bun:test';
+import { Container, database, createEnvBinding, destroyAll } from '../index';
+setDefaultTimeout(30_000);
+const waitUntil = (fn, timeout = 5000) => {
+    return new Promise((resolve) => {
+        const interval = setInterval(() => {
+            if (fn()) {
+                clearInterval(interval);
+                resolve(true);
+            }
+        }, 100);
+    });
+};
+describe('Bindings', () => {
+    afterEach(async () => {
+        await destroyAll();
+    });
+    test('createEnvBinding creates a simple env binding', () => {
+        const binding = createEnvBinding('config', {
+            NODE_ENV: 'test',
+            LOG_LEVEL: 'debug',
+        });
+        expect(binding.type).toBe('config');
+        expect(binding.getEnv()).toEqual({
+            NODE_ENV: 'test',
+            LOG_LEVEL: 'debug',
+        });
+    });
+    test('container receives env vars from bindings', async () => {
+        const configBinding = createEnvBinding('config', {
+            APP_NAME: 'test-app',
+            APP_VERSION: '1.0.0',
+        });
+        const container = await Container('test-binding-env', {
+            image: 'alpine:latest',
+            cmd: ['sleep', '30'],
+            bindings: {
+                config: configBinding,
+            },
+        });
+        await waitUntil(() => !!container.getIp('test-binding-env'), 5000);
+        const result = await container.exec([
+            'sh',
+            '-c',
+            'echo "$APP_NAME:$APP_VERSION"',
+        ]);
+        expect(result.stdout.trim()).toBe('test-app:1.0.0');
+        await container.destroy();
+    });
+    test('multiple bindings merge env vars', async () => {
+        const binding1 = createEnvBinding('env1', {
+            VAR_A: 'a',
+            VAR_B: 'b',
+        });
+        const binding2 = createEnvBinding('env2', {
+            VAR_C: 'c',
+            VAR_D: 'd',
+        });
+        const container = await Container('test-multi-binding', {
+            image: 'alpine:latest',
+            cmd: ['sleep', '30'],
+            bindings: {
+                first: binding1,
+                second: binding2,
+            },
+        });
+        await waitUntil(() => !!container.getIp('test-multi-binding'), 5000);
+        const result = await container.exec([
+            'sh',
+            '-c',
+            'echo "$VAR_A$VAR_B$VAR_C$VAR_D"',
+        ]);
+        expect(result.stdout.trim()).toBe('abcd');
+        await container.destroy();
+    });
+    test('explicit env takes precedence over bindings', async () => {
+        const binding = createEnvBinding('config', {
+            MY_VAR: 'from-binding',
+        });
+        const container = await Container('test-env-precedence', {
+            image: 'alpine:latest',
+            cmd: ['sleep', '30'],
+            bindings: {
+                config: binding,
+            },
+            env: {
+                MY_VAR: 'from-explicit',
+            },
+        });
+        await waitUntil(() => !!container.getIp('test-env-precedence'), 5000);
+        const result = await container.exec(['sh', '-c', 'echo "$MY_VAR"']);
+        expect(result.stdout.trim()).toBe('from-explicit');
+        await container.destroy();
+    });
+    test('database can be used as binding resource', async () => {
+        const db = await database('test-db-binding', {
+            image: 'redis:7-alpine',
+            hostPort: 16390,
+        });
+        const dbBinding = createEnvBinding('database', {
+            REDIS_URL: db.connectionString,
+        });
+        const container = await Container('test-db-consumer', {
+            image: 'alpine:latest',
+            cmd: ['sleep', '30'],
+            bindings: {
+                db: dbBinding,
+            },
+        });
+        await waitUntil(() => !!container.getIp('test-db-consumer'), 5000);
+        const result = await container.exec(['sh', '-c', 'echo "$REDIS_URL"']);
+        expect(result.stdout.trim()).toBe('redis://localhost:16390');
+        await container.destroy();
+        await db.destroy();
+    });
+});

package/dist/__tests__/container.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Container Resource Integration Tests
+ *
+ * Dogfoods the Container resource to verify:
+ * - Creation with network binding
+ * - waitForLog functionality
+ * - exec command execution
+ * - stats retrieval
+ * - Lifecycle (stop, destroy)
+ */
+export {};
+//# sourceMappingURL=container.test.d.ts.map

package/dist/__tests__/container.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/container.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/__tests__/container.test.js

@@ -0,0 +1,115 @@
+/**
+ * Container Resource Integration Tests
+ *
+ * Dogfoods the Container resource to verify:
+ * - Creation with network binding
+ * - waitForLog functionality
+ * - exec command execution
+ * - stats retrieval
+ * - Lifecycle (stop, destroy)
+ */
+import { describe, test, expect, afterEach, setDefaultTimeout } from 'bun:test';
+import { Network, Container, destroyAll } from '../index';
+setDefaultTimeout(30_000);
+describe('Container', () => {
+    afterEach(async () => {
+        await destroyAll();
+    });
+    test('creates a container with basic config', async () => {
+        const container = await Container('test-container-basic', {
+            image: 'alpine:latest',
+            cmd: ['sleep', '30'],
+        });
+        expect(container.id).toBeDefined();
+        expect(container.name).toBe('test-container-basic');
+        await container.destroy();
+    });
+    test('creates a container attached to a network', async () => {
+        const network = await Network('test-container-net');
+        const container = await Container('test-container-networked', {
+            image: 'alpine:latest',
+            cmd: ['sleep', '30'],
+            networks: [network],
+        });
+        expect(container.id).toBeDefined();
+        const ip = await container.getIp('test-container-net');
+        expect(ip).toBeDefined();
+        await container.destroy();
+        await network.destroy();
+    });
+    test('exec runs commands inside container', async () => {
+        const container = await Container('test-container-exec', {
+            image: 'alpine:latest',
+            cmd: ['sleep', '30'],
+        });
+        await new Promise((r) => setTimeout(r, 500));
+        const result = await container.exec(['echo', 'hello world']);
+        expect(result.exitCode).toBe(0);
+        expect(result.stdout.trim()).toBe('hello world');
+        expect(result.durationMs).toBeGreaterThan(0);
+        await container.destroy();
+    });
+    test('stats returns container resource statistics', async () => {
+        const container = await Container('test-container-stats', {
+            image: 'alpine:latest',
+            cmd: ['sleep', '30'],
+        });
+        await new Promise((r) => setTimeout(r, 500));
+        const stats = await container.stats();
+        expect(stats.cpu).toBeDefined();
+        expect(stats.cpu.cores).toBeGreaterThan(0);
+        expect(stats.memory).toBeDefined();
+        expect(stats.memory.limit).toBeGreaterThan(0);
+        expect(stats.network).toBeDefined();
+        expect(stats.containerId).toBe(container.id);
+        await container.destroy();
+    });
+    test('waitForLog detects log patterns', async () => {
+        const container = await Container('test-container-logs', {
+            image: 'alpine:latest',
+            cmd: ['sh', '-c', 'echo "Server started successfully" && sleep 30'],
+        });
+        await container.waitForLog('Server started', 5000);
+        expect(true).toBe(true);
+        await container.destroy();
+    });
+    test('stop gracefully shuts down container', async () => {
+        const container = await Container('test-container-stop', {
+            image: 'alpine:latest',
+            cmd: ['sh', '-c', 'trap "exit 0" TERM; while true; do sleep 1; done'],
+        });
+        await new Promise((r) => setTimeout(r, 500));
+        const metadata = await container.stop('SIGTERM', 10000);
+        expect(metadata.signal).toBe('SIGTERM');
+        expect(metadata.signalCount).toBeGreaterThan(0);
+        expect(metadata.timeTakenMs).toBeGreaterThan(0);
+        await container.destroy();
+    });
+    test('supports environment variables', async () => {
+        const container = await Container('test-container-env', {
+            image: 'alpine:latest',
+            cmd: ['sleep', '30'],
+            env: {
+                MY_VAR: 'hello',
+                ANOTHER_VAR: 'world',
+            },
+        });
+        await new Promise((r) => setTimeout(r, 500));
+        const result = await container.exec([
+            'sh',
+            '-c',
+            'echo $MY_VAR $ANOTHER_VAR',
+        ]);
+        expect(result.stdout.trim()).toBe('hello world');
+        await container.destroy();
+    });
+    test('supports port mappings', async () => {
+        const container = await Container('test-container-ports', {
+            image: 'alpine:latest',
+            cmd: ['sleep', '30'],
+            ports: [{ internal: 8080, external: 18080 }],
+        });
+        expect(container.id).toBeDefined();
+        await container.destroy();
+    });
+});

package/dist/__tests__/database.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Database Helper Integration Tests
+ *
+ * Dogfoods the database helper to verify:
+ * - Connection string generation
+ * - Port mapping
+ * - Database-specific defaults
+ */
+export {};
+//# sourceMappingURL=database.test.d.ts.map

package/dist/__tests__/database.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/database.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/database.test.js

@@ -0,0 +1,92 @@
+/**
+ * Database Helper Integration Tests
+ *
+ * Dogfoods the database helper to verify:
+ * - Connection string generation
+ * - Port mapping
+ * - Database-specific defaults
+ */
+import { describe, test, expect, afterEach, setDefaultTimeout } from 'bun:test';
+import { Network, database, destroyAll } from '../index';
+setDefaultTimeout(60_000);
+describe('database', () => {
+    afterEach(async () => {
+        await destroyAll();
+    });
+    test('creates a postgres database with connection string', async () => {
+        const db = await database('test-postgres', {
+            image: 'postgres:16-alpine',
+            env: {
+                POSTGRES_PASSWORD: 'testpass',
+                POSTGRES_DB: 'testdb',
+            },
+            hostPort: 15432,
+        });
+        expect(db.id).toBeDefined();
+        expect(db.name).toBe('test-postgres');
+        expect(db.port).toBe(5432);
+        expect(db.hostPort).toBe(15432);
+        expect(db.connectionString).toBe('postgresql://postgres:testpass@localhost:15432/testdb');
+        await db.destroy();
+    });
+    test('creates a redis database with connection string', async () => {
+        const db = await database('test-redis', {
+            image: 'redis:7-alpine',
+            hostPort: 16379,
+        });
+        expect(db.port).toBe(6379);
+        expect(db.hostPort).toBe(16379);
+        expect(db.connectionString).toBe('redis://localhost:16379');
+        await db.destroy();
+    });
+    test('creates a redis database with password', async () => {
+        const db = await database('test-redis-auth', {
+            image: 'redis:7-alpine',
+            hostPort: 16380,
+            env: {
+                REDIS_PASSWORD: 'secret',
+            },
+        });
+        expect(db.connectionString).toBe('redis://:secret@localhost:16380');
+        await db.destroy();
+    });
+    test('creates a mysql database with connection string', async () => {
+        const db = await database('test-mysql', {
+            image: 'mysql:8',
+            env: {
+                MYSQL_ROOT_PASSWORD: 'rootpass',
+                MYSQL_DATABASE: 'mydb',
+            },
+            hostPort: 13306,
+        });
+        expect(db.port).toBe(3306);
+        expect(db.hostPort).toBe(13306);
+        expect(db.connectionString).toBe('mysql://root:rootpass@localhost:13306/mydb');
+        await db.destroy();
+    });
+    test('attaches database to network', async () => {
+        const network = await Network('test-db-net');
+        const db = await database('test-db-networked', {
+            image: 'redis:7-alpine',
+            networks: [network],
+            hostPort: 16381,
+        });
+        const ip = await db.getIp('test-db-net');
+        expect(ip).toBeDefined();
+        expect(ip).not.toBe('');
+        await db.destroy();
+        await network.destroy();
+    });
+    test('database inherits container methods', async () => {
+        const db = await database('test-db-methods', {
+            image: 'redis:7-alpine',
+            hostPort: 16382,
+        });
+        await db.waitForLog('Ready to accept connections', 10000);
+        const result = await db.exec(['redis-cli', 'PING']);
+        expect(result.stdout.trim()).toBe('PONG');
+        const stats = await db.stats();
+        expect(stats.cpu).toBeDefined();
+        await db.destroy();
+    });
+});

package/dist/__tests__/network.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Network Resource Integration Tests
+ *
+ * Dogfoods the Network resource to verify:
+ * - Creation and destruction
+ * - Property access (id, name)
+ * - Duplicate network handling
+ */
+export {};
+//# sourceMappingURL=network.test.d.ts.map

package/dist/__tests__/network.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/network.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/network.test.js

@@ -0,0 +1,44 @@
+/**
+ * Network Resource Integration Tests
+ *
+ * Dogfoods the Network resource to verify:
+ * - Creation and destruction
+ * - Property access (id, name)
+ * - Duplicate network handling
+ */
+import { describe, test, expect, afterEach, setDefaultTimeout } from 'bun:test';
+import { Network, destroyAll } from '../index';
+setDefaultTimeout(30_000);
+describe('Network', () => {
+    afterEach(async () => {
+        await destroyAll();
+    });
+    test('creates a network and returns resource with id and name', async () => {
+        const network = await Network('test-network-basic');
+        expect(network.id).toBeDefined();
+        expect(network.id.length).toBeGreaterThan(0);
+        expect(network.name).toBe('test-network-basic');
+        await network.destroy();
+    });
+    test('allows custom driver configuration', async () => {
+        const network = await Network('test-network-custom', {
+            driver: 'bridge',
+        });
+        expect(network.name).toBe('test-network-custom');
+        expect(network.id).toBeDefined();
+        await network.destroy();
+    });
+    test('handles creating network with same name (replaces existing)', async () => {
+        const network1 = await Network('test-network-duplicate');
+        const id1 = network1.id;
+        const network2 = await Network('test-network-duplicate');
+        const id2 = network2.id;
+        expect(id2).not.toBe(id1);
+        await network2.destroy();
+    });
+    test('destroy is idempotent', async () => {
+        const network = await Network('test-network-idempotent');
+        await network.destroy();
+        expect(network.destroy()).resolves.toBeUndefined();
+    });
+});

package/dist/api/index.d.ts

@@ -3,5 +3,5 @@
  *
  * Re-exports the Promise-based API for cleaner imports.
  */
-export { Network, Container, database, Image, setDocker, resetDocker, destroyAll, type NetworkConfig, type NetworkResource, type ContainerConfig, type ContainerResource, type PortMapping, type ShutdownMetadata, type DatabaseConfig, type DatabaseResource, type ImageConfig, type ImageResource, } from './promise';
+export { Network, Container, database, Image, setDocker, resetDocker, destroyAll, type NetworkConfig, type NetworkResource, type ContainerConfig, type ContainerResource, type PortMapping, type ShutdownMetadata, type DatabaseConfig, type DatabaseResource, type ImageConfig, type ImageResource, type ContainerStats, type ExecOptions, type ExecResult, type LogOptions, type LogLine, } from './promise';
 //# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,OAAO,EACP,SAAS,EACT,QAAQ,EACR,KAAK,EAGL,SAAS,EACT,WAAW,EACX,UAAU,EAGV,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,OAAO,EACP,SAAS,EACT,QAAQ,EACR,KAAK,EAGL,SAAS,EACT,WAAW,EACX,UAAU,EAGV,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,aAAa,EAGlB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,OAAO,GACb,MAAM,WAAW,CAAC"}

package/dist/api/promise.d.ts

@@ -7,6 +7,8 @@
  * Inspired by Alchemy.run and Pulumi's IAC patterns.
  */
 import Docker from 'dockerode';
+import { type ContainerStats, type ExecOptions, type ExecResult, type LogOptions, type LogLine } from '../resources';
+export type { ContainerStats, ExecOptions, ExecResult, LogOptions, LogLine, } from '../resources';
 import type { Binding } from '../bindings/types';
 export interface NetworkConfig {
     /** Network driver (default: 'bridge') */
@@ -49,6 +51,12 @@ export interface ContainerResource {
     stop(signal?: string, timeoutMs?: number): Promise<ShutdownMetadata>;
     /** Get container IP in a network */
     getIp(networkName: string): Promise<string>;
+    /** Get container resource statistics (CPU, memory, network) */
+    stats(): Promise<ContainerStats>;
+    /** Execute a command inside the container */
+    exec(cmd: string[], options?: Omit<ExecOptions, 'cmd'>): Promise<ExecResult>;
+    /** Stream container logs as an async iterable */
+    streamLogs(options?: LogOptions): Promise<AsyncIterable<LogLine>>;
     /** Remove this container */
     destroy(): Promise<void>;
 }

package/dist/api/promise.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"promise.d.ts","sourceRoot":"","sources":["../../src/api/promise.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"promise.d.ts","sourceRoot":"","sources":["../../src/api/promise.ts"],"names":[],"mappings":"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"}

package/dist/api/promise.js

@@ -7,8 +7,9 @@
  * Inspired by Alchemy.run and Pulumi's IAC patterns.
  */
 import { Effect, Scope, Exit } from 'effect';
-import { homedir } from 'os';
+import { homedir, platform } from 'os';
 import { existsSync } from 'fs';
+import { spawn } from 'child_process';
 import Docker from 'dockerode';
 // Import Effect-based resources (internal only)
 import { Network as EffectNetwork, Container as EffectContainer, Image as EffectImage, } from '../resources';
@@ -44,6 +45,92 @@ function getDocker() {
     }
     return dockerClient;
 }
+// ============ Docker Auto-Start (Alchemy.run Style) ============
+const DOCKER_STARTUP_TIMEOUT_MS = 60_000;
+let dockerEnsured = false;
+/**
+ * Start Docker Desktop on macOS/Windows if not running.
+ */
+function startDockerDesktop() {
+    const os = platform();
+    if (os === 'darwin') {
+        console.log('[Harpoon] Starting Docker Desktop...');
+        const child = spawn('open', ['-a', 'Docker', '--background'], {
+            detached: true,
+            stdio: 'ignore',
+        });
+        child.unref();
+    }
+    else if (os === 'win32') {
+        console.log('[Harpoon] Starting Docker Desktop...');
+        const child = spawn('cmd', ['/c', 'start', '', 'Docker Desktop'], {
+            detached: true,
+            stdio: 'ignore',
+        });
+        child.unref();
+    }
+    // Linux: Docker daemon managed by systemd, no auto-start
+}
+/**
+ * Wait for Docker daemon to be ready with polling.
+ */
+async function waitForDockerReady(socketPath, timeoutMs) {
+    const start = Date.now();
+    let lastError = null;
+    while (Date.now() - start < timeoutMs) {
+        try {
+            if (existsSync(socketPath)) {
+                const docker = new Docker({ socketPath });
+                await docker.ping();
+                console.log('[Harpoon] Docker is ready');
+                return;
+            }
+        }
+        catch (e) {
+            lastError = e;
+        }
+        await new Promise(r => setTimeout(r, 500));
+    }
+    throw new Error(`[Harpoon] Docker not ready after ${timeoutMs}ms: ${lastError?.message}`);
+}
+/**
+ * Ensure Docker is running, auto-starting if needed.
+ * This is the Alchemy.run-style declarative approach.
+ */
+async function ensureDockerRunning() {
+    if (dockerEnsured)
+        return;
+    const socketPath = detectDockerSocket();
+    // Check if already running
+    if (existsSync(socketPath)) {
+        try {
+            const docker = new Docker({ socketPath });
+            await docker.ping();
+            dockerEnsured = true;
+            return; // Docker is ready
+        }
+        catch {
+            // Socket exists but daemon not responding, wait for it
+            console.log('[Harpoon] Docker socket exists but daemon not responding, waiting...');
+        }
+    }
+    else {
+        // Socket doesn't exist, start Docker
+        console.log('[Harpoon] Docker not running, attempting auto-start...');
+        startDockerDesktop();
+    }
+    // Wait for Docker to be ready
+    await waitForDockerReady(socketPath, DOCKER_STARTUP_TIMEOUT_MS);
+    dockerEnsured = true;
+}
+/**
+ * Get Docker client with auto-start support.
+ * Ensures Docker is running before returning client.
+ */
+async function getDockerAsync() {
+    await ensureDockerRunning();
+    return getDocker();
+}
 /**
  * Set a custom Docker client.
  * Useful for testing or custom configurations.
@@ -100,7 +187,7 @@ function registerCleanup() {
  */
 export async function Network(name, config = {}) {
     registerCleanup();
-    const docker = getDocker();
+    const docker = await getDockerAsync();
     const scope = Effect.runSync(Scope.make());
     const effectConfig = {
         name,
@@ -139,7 +226,7 @@ export async function Network(name, config = {}) {
  */
 export async function Container(name, config) {
     registerCleanup();
-    const docker = getDocker();
+    const docker = await getDockerAsync();
     const scope = Effect.runSync(Scope.make());
     // Convert NetworkResource to { name: string }
     const networks = config.networks?.map((n) => 'destroy' in n ? { name: n.name } : n);
@@ -169,6 +256,15 @@ export async function Container(name, config) {
         async getIp(networkName) {
             return Effect.runPromise(effectResource.getIp(networkName));
         },
+        async stats() {
+            return Effect.runPromise(effectResource.stats());
+        },
+        async exec(cmd, options) {
+            return Effect.runPromise(effectResource.exec({ cmd, ...options }));
+        },
+        async streamLogs(options) {
+            return Effect.runPromise(effectResource.streamLogs(options));
+        },
         async destroy() {
             await cleanup();
             resources.delete(resourceId);
@@ -199,7 +295,7 @@ export async function Container(name, config) {
  */
 export async function database(name, config) {
     registerCleanup();
-    const docker = getDocker();
+    const docker = await getDockerAsync();
     const scope = Effect.runSync(Scope.make());
     // Convert NetworkResource to { name: string }
     const networks = config.networks?.map((n) => 'destroy' in n ? { name: n.name } : n);
@@ -232,6 +328,15 @@ export async function database(name, config) {
         async getIp(networkName) {
             return Effect.runPromise(effectResource.getIp(networkName));
         },
+        async stats() {
+            return Effect.runPromise(effectResource.stats());
+        },
+        async exec(cmd, options) {
+            return Effect.runPromise(effectResource.exec({ cmd, ...options }));
+        },
+        async streamLogs(options) {
+            return Effect.runPromise(effectResource.streamLogs(options));
+        },
         async destroy() {
             await cleanup();
             resources.delete(resourceId);

package/dist/build-strategies/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/build-strategies/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,sDAAsD;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEtD,uCAAuC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAElC,mDAAmD;IACnD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAEjC,gCAAgC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,oCAAoC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,gEAAgE;IAChE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAElC,2CAA2C;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAEpC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAG,oBAAoB,CAAU;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;gBAEvB,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAYjE;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,CAChB,KAAK,EAAE,kBAAkB,KACtB,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;IAE1D,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAErD,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;CACxC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/build-strategies/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,sDAAsD;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEtD,uCAAuC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAElC,mDAAmD;IACnD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAEjC,gCAAgC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,oCAAoC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,gEAAgE;IAChE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAElC,2CAA2C;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAEpC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,uBAAiC;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAEnC,YAAY,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAW/D;CACF;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,CAChB,KAAK,EAAE,kBAAkB,KACtB,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;IAE1D,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAErD,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;CACxC"}