@docker-harpoon/core 0.1.5 → 0.3.0

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,44 +7,15 @@
  * Inspired by Harpoon and Pulumi's IAC patterns.
  */
 import { Effect, Scope, Exit } from 'effect';
-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';
 import { database as effectDatabase, } from '../helpers';
+import { createDockerClient, DockerResolutionError, formatDockerConnectionFailure, resolveDockerConnection, } from '../docker-resolver';
 // Binding type is used as-is from internal types
 // Pre-built bindings like PrismaBinding handle Effect internally
 // Users creating simple bindings can use createEnvBinding()
 // ============ Docker Client Management ============
 let dockerClient = null;
-/**
- * Detect Docker socket path for the current platform.
- */
-function detectDockerSocket() {
-    const candidates = ['/var/run/docker.sock', `${homedir()}/.docker/run/docker.sock`];
-    for (const path of candidates) {
-        if (existsSync(path)) {
-            return path;
-        }
-    }
-    // Windows uses named pipes, let dockerode handle it
-    return '/var/run/docker.sock';
-}
-/**
- * Get the Docker client, auto-detecting the socket if needed.
- */
-function getDocker() {
-    if (!dockerClient) {
-        const socketPath = detectDockerSocket();
-        dockerClient = new Docker({ socketPath });
-    }
-    return dockerClient;
-}
-// ============ Docker Auto-Start (Harpoon Style) ============
-const DOCKER_STARTUP_TIMEOUT_MS = 60_000;
-let dockerEnsured = false;
 /**
  * Simple logging helper for promise-based API.
  */
@@ -59,87 +30,38 @@ const harpoonLog = {
     error: (message, err) => console.error(`[Harpoon] ${message}`, err ?? ''),
 };
 /**
- * Start Docker Desktop on macOS/Windows if not running.
+ * Get Docker client with shared endpoint discovery.
  */
-function startDockerDesktop() {
-    const os = platform();
-    if (os === 'darwin') {
-        harpoonLog.info('Starting Docker Desktop...');
-        const child = spawn('open', ['-a', 'Docker', '--background'], {
-            detached: true,
-            stdio: 'ignore',
-        });
-        child.unref();
+async function getDockerAsync() {
+    if (dockerClient) {
+        return dockerClient;
     }
-    else if (os === 'win32') {
-        harpoonLog.info('Starting Docker Desktop...');
-        const child = spawn('cmd', ['/c', 'start', '', 'Docker Desktop'], {
-            detached: true,
-            stdio: 'ignore',
-        });
-        child.unref();
+    let resolution;
+    try {
+        resolution = resolveDockerConnection();
     }
-    // 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();
-                harpoonLog.info('Docker is ready');
-                return;
-            }
+    catch (error) {
+        if (error instanceof DockerResolutionError) {
+            const lines = [
+                'Failed to resolve Docker endpoint.',
+                error.message,
+                'Harpoon will not launch Docker (desktop, engine, or other runtimes) automatically. Start your configured Docker runtime, or set DOCKER_SOCKET, DOCKER_HOST, or DOCKER_CONTEXT to a local Docker endpoint.',
+                'You can also inject a Docker client with setDocker().',
+            ];
+            throw new Error(lines.join('\n'));
         }
-        catch (e) {
-            lastError = e;
-        }
-        await new Promise((r) => setTimeout(r, 500));
+        throw error;
     }
-    throw new Error(`Docker not ready after ${timeoutMs}ms: ${lastError?.message}`);
-}
-/**
- * Ensure Docker is running, auto-starting if needed.
- * This is the Harpoon-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
-            harpoonLog.debug('Docker socket exists but daemon not responding, waiting...');
-        }
+    const docker = createDockerClient(resolution);
+    try {
+        await docker.ping();
     }
-    else {
-        // Socket doesn't exist, start Docker
-        harpoonLog.info('Docker not running, attempting auto-start...');
-        startDockerDesktop();
+    catch (error) {
+        throw new Error(formatDockerConnectionFailure(resolution, error));
     }
-    // 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();
+    harpoonLog.debug(`Connected to Docker daemon via ${resolution.sourceDescription}`);
+    dockerClient = docker;
+    return dockerClient;
 }
 /**
  * Set a custom Docker client.

package/dist/docker-resolver.d.ts

@@ -0,0 +1,36 @@
+import Docker from 'dockerode';
+interface DockerResolutionFileSystem {
+    existsSync: (filePath: string) => boolean;
+    readFileSync: (filePath: string) => string;
+    readdirSync: (directoryPath: string) => string[];
+}
+export interface ResolveDockerConnectionOptions {
+    readonly explicitSocketPath?: string;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly homeDir?: string;
+    readonly platform?: NodeJS.Platform;
+    readonly fs?: DockerResolutionFileSystem;
+}
+export interface DockerConnectionResolution {
+    readonly dockerOptions: Docker.DockerOptions;
+    readonly endpoint: string;
+    readonly socketPath: string;
+    readonly source: string;
+    readonly sourceDescription: string;
+    readonly triedEndpoints: readonly string[];
+}
+export declare class DockerResolutionError extends Error {
+    readonly source: string;
+    readonly triedEndpoints: readonly string[];
+    readonly cause: Error | undefined;
+    constructor(message: string, options: {
+        source: string;
+        triedEndpoints?: readonly string[];
+        cause?: unknown;
+    });
+}
+export declare function resolveDockerConnection(options?: ResolveDockerConnectionOptions): DockerConnectionResolution;
+export declare function createDockerClient(options?: ResolveDockerConnectionOptions | DockerConnectionResolution): Docker;
+export declare function formatDockerConnectionFailure(resolution: DockerConnectionResolution, cause: unknown, injectedClientHint?: string): string;
+export {};
+//# sourceMappingURL=docker-resolver.d.ts.map

package/dist/docker-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-resolver.d.ts","sourceRoot":"","sources":["../src/docker-resolver.ts"],"names":[],"mappings":"AAGA,OAAO,MAAM,MAAM,WAAW,CAAC;AAS/B,UAAU,0BAA0B;IAClC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,WAAW,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;CAClD;AAQD,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,EAAE,0BAA0B,CAAC;CAC1C;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAE3C,SAAkB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IAE3C,YACE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACnC,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,EAWF;CACF;AAyND,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,8BAAmC,GAC3C,0BAA0B,CAqE5B;AAED,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,8BAA8B,GAAG,0BAA+B,GACxE,MAAM,CAIR;AAED,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,0BAA0B,EACtC,KAAK,EAAE,OAAO,EACd,kBAAkB,SAAgB,GACjC,MAAM,CAiBR"}

package/dist/docker-resolver.js

@@ -0,0 +1,214 @@
+import { existsSync, readFileSync, readdirSync } from 'fs';
+import { homedir, platform as osPlatform } from 'os';
+import path from 'path';
+import Docker from 'dockerode';
+const WINDOWS_DOCKER_PIPE = '//./pipe/docker_engine';
+// Docker's built-in "default" context has no on-disk metadata in
+// ~/.docker/contexts/meta/ and must be treated the same as having no context
+// configured, falling through to the local socket candidate search.
+const DOCKER_DEFAULT_CONTEXT = 'default';
+const defaultFileSystem = {
+    existsSync,
+    readFileSync: (filePath) => readFileSync(filePath, 'utf-8'),
+    readdirSync: (directoryPath) => readdirSync(directoryPath),
+};
+export class DockerResolutionError extends Error {
+    source;
+    triedEndpoints;
+    cause;
+    constructor(message, options) {
+        super(message);
+        this.name = 'DockerResolutionError';
+        this.source = options.source;
+        this.triedEndpoints = options.triedEndpoints ?? [];
+        this.cause = asError(options.cause);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, DockerResolutionError);
+        }
+    }
+}
+const asError = (value) => {
+    if (value === undefined) {
+        return undefined;
+    }
+    return value instanceof Error ? value : new Error(String(value));
+};
+const buildResolutionError = (message, source, triedEndpoints = [], cause) => new DockerResolutionError(message, {
+    source,
+    triedEndpoints,
+    cause,
+});
+const getLocalDockerSocketCandidates = (homeDirectory, platform) => {
+    if (platform === 'win32') {
+        return [WINDOWS_DOCKER_PIPE];
+    }
+    const candidates = ['/var/run/docker.sock'];
+    if (homeDirectory) {
+        candidates.push(`${homeDirectory}/.docker/run/docker.sock`, `${homeDirectory}/.docker/desktop/docker.sock`, `${homeDirectory}/.rd/docker.sock`, `${homeDirectory}/.colima/default/docker.sock`, `${homeDirectory}/.orbstack/run/docker.sock`);
+    }
+    return candidates;
+};
+const normalizePipePath = (value) => {
+    const withForwardSlashes = value.replace(/\\/g, '/');
+    if (withForwardSlashes.startsWith('//./pipe/')) {
+        return withForwardSlashes;
+    }
+    const trimmed = withForwardSlashes.replace(/^\/+/, '');
+    if (trimmed.startsWith('./pipe/')) {
+        return `//${trimmed}`;
+    }
+    if (trimmed.startsWith('pipe/')) {
+        return `//./${trimmed}`;
+    }
+    return withForwardSlashes;
+};
+const normalizeDockerHost = (value, sourceDescription) => {
+    if (value.startsWith('unix://')) {
+        const encoded = value.slice('unix://'.length);
+        try {
+            return decodeURIComponent(encoded);
+        }
+        catch (cause) {
+            throw buildResolutionError(`Malformed percent-encoding in ${sourceDescription} value "${value}". The path portion "${encoded}" is not valid URI-encoded text.`, sourceDescription, [value], cause);
+        }
+    }
+    if (value.startsWith('npipe://')) {
+        return normalizePipePath(value.slice('npipe://'.length));
+    }
+    const hasUriScheme = /^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(value);
+    if (hasUriScheme) {
+        throw buildResolutionError(`Unsupported ${sourceDescription} value "${value}". Harpoon currently supports only local Docker endpoints via raw socket paths, unix://, or npipe://.`, sourceDescription, [value]);
+    }
+    if (value.startsWith('\\\\.\\pipe\\') || value.startsWith('//./pipe/')) {
+        return normalizePipePath(value);
+    }
+    return value;
+};
+const makeResolution = (socketPath, endpoint, source, sourceDescription, triedEndpoints) => ({
+    dockerOptions: { socketPath },
+    endpoint,
+    socketPath,
+    source,
+    sourceDescription,
+    triedEndpoints,
+});
+const resolveDirectSocket = (value, source, sourceDescription) => {
+    const socketPath = normalizeDockerHost(value, sourceDescription);
+    return makeResolution(socketPath, value, source, sourceDescription, [socketPath]);
+};
+const readJson = (filePath, fileSystem) => {
+    if (!fileSystem.existsSync(filePath)) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(fileSystem.readFileSync(filePath));
+    }
+    catch {
+        return undefined;
+    }
+};
+const readCurrentDockerContext = (homeDirectory, fileSystem) => {
+    if (!homeDirectory) {
+        return undefined;
+    }
+    const configPath = path.join(homeDirectory, '.docker', 'config.json');
+    const config = readJson(configPath, fileSystem);
+    if (!config) {
+        return undefined;
+    }
+    const currentContext = config['currentContext'];
+    return typeof currentContext === 'string' &&
+        currentContext.length > 0 &&
+        currentContext !== DOCKER_DEFAULT_CONTEXT
+        ? currentContext
+        : undefined;
+};
+const resolveDockerContext = (contextName, source, sourceDescription, homeDirectory, fileSystem) => {
+    if (!homeDirectory) {
+        throw buildResolutionError(`Unable to resolve ${sourceDescription}. No home directory is available for Docker context lookup.`, source);
+    }
+    const contextsDirectory = path.join(homeDirectory, '.docker', 'contexts', 'meta');
+    let entries;
+    try {
+        entries = fileSystem.readdirSync(contextsDirectory);
+    }
+    catch (error) {
+        throw buildResolutionError(`Unable to resolve ${sourceDescription}. Docker context metadata was not found at ${contextsDirectory}.`, source, [contextsDirectory], error);
+    }
+    for (const entry of entries) {
+        const metaPath = path.join(contextsDirectory, entry, 'meta.json');
+        const meta = readJson(metaPath, fileSystem);
+        if (!meta || meta['Name'] !== contextName) {
+            continue;
+        }
+        const endpoints = meta['Endpoints'];
+        const dockerEndpoint = endpoints && typeof endpoints === 'object'
+            ? endpoints['docker']
+            : undefined;
+        const host = dockerEndpoint && typeof dockerEndpoint === 'object'
+            ? dockerEndpoint['Host']
+            : undefined;
+        if (typeof host !== 'string' || host.length === 0) {
+            throw buildResolutionError(`Docker context "${contextName}" does not define a Docker host endpoint.`, source, [metaPath]);
+        }
+        const socketPath = normalizeDockerHost(host, sourceDescription);
+        return makeResolution(socketPath, host, source, sourceDescription, [socketPath]);
+    }
+    throw buildResolutionError(`Docker context "${contextName}" was not found in ${contextsDirectory}.`, source, [contextsDirectory]);
+};
+export function resolveDockerConnection(options = {}) {
+    const fileSystem = options.fs ?? defaultFileSystem;
+    const env = options.env ?? process.env;
+    const homeDirectory = options.homeDir ?? homedir();
+    const platform = options.platform ?? osPlatform();
+    if (options.explicitSocketPath) {
+        return resolveDirectSocket(options.explicitSocketPath, 'explicitSocketPath', 'explicit socket override');
+    }
+    const dockerSocket = env.DOCKER_SOCKET;
+    if (dockerSocket) {
+        return resolveDirectSocket(dockerSocket, 'DOCKER_SOCKET', 'DOCKER_SOCKET');
+    }
+    const dockerHost = env.DOCKER_HOST;
+    if (dockerHost) {
+        return resolveDirectSocket(dockerHost, 'DOCKER_HOST', 'DOCKER_HOST');
+    }
+    const dockerContext = env.DOCKER_CONTEXT;
+    if (dockerContext && dockerContext !== DOCKER_DEFAULT_CONTEXT) {
+        return resolveDockerContext(dockerContext, 'DOCKER_CONTEXT', `DOCKER_CONTEXT=${dockerContext}`, homeDirectory, fileSystem);
+    }
+    const currentContext = readCurrentDockerContext(homeDirectory, fileSystem);
+    if (currentContext) {
+        return resolveDockerContext(currentContext, 'currentContext', `Docker currentContext=${currentContext}`, homeDirectory, fileSystem);
+    }
+    const candidates = getLocalDockerSocketCandidates(homeDirectory, platform);
+    let resolvedSocketPath;
+    const triedEndpoints = [];
+    for (const candidatePath of candidates) {
+        triedEndpoints.push(candidatePath);
+        if (fileSystem.existsSync(candidatePath)) {
+            resolvedSocketPath = candidatePath;
+            break;
+        }
+    }
+    if (resolvedSocketPath === undefined) {
+        resolvedSocketPath = candidates[0];
+    }
+    return makeResolution(resolvedSocketPath, resolvedSocketPath, 'fallback', 'fallback socket search', triedEndpoints);
+}
+export function createDockerClient(options = {}) {
+    const resolution = 'dockerOptions' in options ? options : resolveDockerConnection(options);
+    return new Docker(resolution.dockerOptions);
+}
+export function formatDockerConnectionFailure(resolution, cause, injectedClientHint = 'setDocker()') {
+    const lines = ['Failed to connect to Docker daemon.'];
+    lines.push(`Source: ${resolution.sourceDescription}`);
+    lines.push(`Endpoint: ${resolution.endpoint}`);
+    lines.push(`Tried: ${resolution.triedEndpoints.join(', ')}`);
+    const error = asError(cause);
+    if (error?.message) {
+        lines.push(`Cause: ${error.message}`);
+    }
+    lines.push('Harpoon will not launch Docker (desktop, engine, or other runtimes) automatically. Start your configured Docker runtime, or set DOCKER_SOCKET, DOCKER_HOST, or DOCKER_CONTEXT to a local Docker endpoint.');
+    lines.push(`You can also inject a Docker client with ${injectedClientHint}.`);
+    return lines.join('\n');
+}

package/dist/index.d.ts

@@ -28,6 +28,7 @@
  * - BuildBinding interface for Dockerfile transformations
  */
 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, type VolumeMapping, } from './api';
+export { createDockerClient, resolveDockerConnection, formatDockerConnectionFailure, DockerResolutionError, type ResolveDockerConnectionOptions, type DockerConnectionResolution, } from './docker-resolver';
 export type { Binding, BuildBinding, BindingsEnv, FlatBindingsEnv } from './bindings';
 export { isBuildBinding, mergeBindingsEnv, createEnvBinding } from './bindings';
 export { HarpoonError, NetworkError, ImageError, ContainerError, ScopeError, BindingError, toHarpoonError, asCause, isHarpoonError, isNetworkError, isImageError, isContainerError, isScopeError, isBindingError, } from './errors';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,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,EACZ,KAAK,aAAa,GACnB,MAAM,OAAO,CAAC;AAIf,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEtF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAIhF,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,cAAc,EACd,UAAU,EACV,YAAY,EACZ,cAAc,EACd,OAAO,EACP,cAAc,EACd,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAIhD,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,8BAA8B,EAC9B,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,MAAM,EACN,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,GAChB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,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,EACZ,KAAK,aAAa,GACnB,MAAM,OAAO,CAAC;AAEf,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,6BAA6B,EAC7B,qBAAqB,EACrB,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,GAChC,MAAM,mBAAmB,CAAC;AAI3B,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEtF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAIhF,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,cAAc,EACd,UAAU,EACV,YAAY,EACZ,cAAc,EACd,OAAO,EACP,cAAc,EACd,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAIhD,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,8BAA8B,EAC9B,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,MAAM,EACN,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,GAChB,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -33,6 +33,7 @@ export {
 Network, Container, database, Image, 
 // Docker client management
 setDocker, resetDocker, destroyAll, } from './api';
+export { createDockerClient, resolveDockerConnection, formatDockerConnectionFailure, DockerResolutionError, } from './docker-resolver';
 export { isBuildBinding, mergeBindingsEnv, createEnvBinding } from './bindings';
 // ============ Errors ============
 export { HarpoonError, NetworkError, ImageError, ContainerError, ScopeError, BindingError, toHarpoonError, asCause, isHarpoonError, isNetworkError, isImageError, isContainerError, isScopeError, isBindingError, } from './errors';

package/dist/services/DockerClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DockerClient.d.ts","sourceRoot":"","sources":["../../src/services/DockerClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAS,MAAM,QAAQ,CAAC;AACvD,OAAO,MAAM,MAAM,WAAW,CAAC;AAI/B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,qBAAqB,EACrB,cAAc,EAGf,MAAM,gBAAgB,CAAC;AAGxB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE;QACX,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC,CAAC;QAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,gBAAgB,CAAC,EAAE;QACjB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC1C,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAE9B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAEhE,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAE5E,sBAAsB;IACtB,QAAQ,CAAC,cAAc,EAAE,CACvB,OAAO,CAAC,EAAE,qBAAqB,KAC5B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,cAAc,CAAC,CAAC;IAE3D,4BAA4B;IAC5B,QAAQ,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,SAAS,CAAC;IAExD,6BAA6B;IAC7B,QAAQ,CAAC,eAAe,EAAE,CACxB,OAAO,EAAE,sBAAsB,KAC5B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAErD,oBAAoB;IACpB,QAAQ,CAAC,YAAY,EAAE,CACrB,OAAO,CAAC,EAAE,mBAAmB,KAC1B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,cAAc,CAAC,CAAC;IAEhE,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,OAAO,CAAC;IAEpD,2BAA2B;IAC3B,QAAQ,CAAC,aAAa,EAAE,CACtB,OAAO,EAAE,oBAAoB,KAC1B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAEnD,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC;IAElD,kBAAkB;IAClB,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,cAAc,CAAC,CAAC;IAE7E,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,KAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;CAC1C;;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,iBAG/B;CAAG;AAuCN;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,iEAqIe,CAAC;AAoC7C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,yCAmCG,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,oBAAoB,sFAyB7B,CAAC"}
+{"version":3,"file":"DockerClient.d.ts","sourceRoot":"","sources":["../../src/services/DockerClient.ts"],"names":[],"mappings":"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"}

package/dist/services/DockerClient.js

@@ -6,8 +6,7 @@
  */
 import { Context, Effect, Layer } from 'effect';
 import Docker from 'dockerode';
-import { existsSync } from 'fs';
-import { homedir, platform } from 'os';
+import { formatDockerConnectionFailure, resolveDockerConnection } from '../docker-resolver';
 import { HarpoonConfig } from './HarpoonConfig';
 import { DockerConnectionError, wrapAsDockerError, isTransientError, } from './DockerErrors';
 import { DockerRateLimiter, DockerRateLimiterLive, dockerRetrySchedule } from './DockerRateLimiter';
@@ -16,28 +15,6 @@ import { DockerRateLimiter, DockerRateLimiterLive, dockerRetrySchedule } from '.
  */
 export class DockerClient extends Context.Tag('@harpoon/DockerClient')() {
 }
-/**
- * Detect Docker socket path for the current platform.
- */
-function detectDockerSocket() {
-    const candidates = [
-        '/var/run/docker.sock',
-        `${homedir()}/.docker/run/docker.sock`,
-        // Colima on macOS
-        `${homedir()}/.colima/default/docker.sock`,
-    ];
-    for (const path of candidates) {
-        if (existsSync(path)) {
-            return path;
-        }
-    }
-    // Windows uses named pipes, let dockerode handle it
-    if (platform() === 'win32') {
-        return '//./pipe/docker_engine';
-    }
-    // Default fallback
-    return '/var/run/docker.sock';
-}
 /**
  * Helper to add retry logic for transient errors.
  */
@@ -58,14 +35,23 @@ const withRetryOnTransient = (effect) => effect.pipe(Effect.retry({
 export const DockerClientLive = Layer.scoped(DockerClient, Effect.gen(function* () {
     const config = yield* HarpoonConfig;
     const rateLimiter = yield* DockerRateLimiter;
-    // Determine socket path
-    const socketPath = config.dockerSocket ?? detectDockerSocket();
+    const resolution = yield* Effect.try({
+        try: () => resolveDockerConnection({
+            ...(config.dockerSocket !== undefined && {
+                explicitSocketPath: config.dockerSocket,
+            }),
+        }),
+        catch: (e) => new DockerConnectionError(e instanceof Error ? e.message : String(e), {
+            cause: e,
+        }),
+    });
+    const socketPath = resolution.socketPath;
     // Create Docker client
-    const docker = new Docker({ socketPath });
+    const docker = new Docker(resolution.dockerOptions);
     // Verify connection on startup (with retry for transient errors)
     yield* Effect.tryPromise({
         try: () => docker.ping(),
-        catch: (e) => new DockerConnectionError(`Failed to connect to Docker daemon`, {
+        catch: (e) => new DockerConnectionError(formatDockerConnectionFailure(resolution, e, 'a custom DockerClient layer'), {
             socketPath,
             cause: e,
         }),
@@ -79,7 +65,7 @@ export const DockerClientLive = Layer.scoped(DockerClient, Effect.gen(function*
         client: docker,
         ping: () => rateLimiter.withPermit(Effect.tryPromise({
             try: () => docker.ping(),
-            catch: (e) => new DockerConnectionError(`Docker ping failed`, {
+            catch: (e) => new DockerConnectionError(formatDockerConnectionFailure(resolution, e, 'a custom DockerClient layer'), {
                 socketPath,
                 cause: e,
             }),

package/dist/services/HarpoonConfig.d.ts

@@ -24,7 +24,7 @@ export interface HarpoonConfigService {
     readonly retryAttempts: number;
     /** Delay between retry attempts */
     readonly retryDelay: Duration.Duration;
-    /** Docker startup timeout (for auto-start on macOS/Windows) */
+    /** Legacy Docker startup timeout setting. Currently unused. */
     readonly dockerStartupTimeout: Duration.Duration;
 }
 declare const HarpoonConfig_base: Context.TagClass<HarpoonConfig, "@harpoon/HarpoonConfig", HarpoonConfigService>;
@@ -44,7 +44,7 @@ export declare class HarpoonConfig extends HarpoonConfig_base {
  * - HARPOON_PARALLEL_LIMIT: Max parallel operations (default: 4)
  * - HARPOON_RETRY_ATTEMPTS: Retry attempts (default: 3)
  * - HARPOON_RETRY_DELAY: Retry delay in milliseconds (default: 1000)
- * - HARPOON_DOCKER_STARTUP_TIMEOUT: Docker startup timeout in milliseconds (default: 60000)
+ * - HARPOON_DOCKER_STARTUP_TIMEOUT: Legacy Docker startup timeout in milliseconds (default: 60000)
  */
 export declare const HarpoonConfigLive: Layer.Layer<HarpoonConfig, import("effect/ConfigError").ConfigError, never>;
 /**

package/dist/services/HarpoonConfig.js

@@ -21,7 +21,7 @@ export class HarpoonConfig extends Context.Tag('@harpoon/HarpoonConfig')() {
  * - HARPOON_PARALLEL_LIMIT: Max parallel operations (default: 4)
  * - HARPOON_RETRY_ATTEMPTS: Retry attempts (default: 3)
  * - HARPOON_RETRY_DELAY: Retry delay in milliseconds (default: 1000)
- * - HARPOON_DOCKER_STARTUP_TIMEOUT: Docker startup timeout in milliseconds (default: 60000)
+ * - HARPOON_DOCKER_STARTUP_TIMEOUT: Legacy Docker startup timeout in milliseconds (default: 60000)
  */
 export const HarpoonConfigLive = Layer.effect(HarpoonConfig, Effect.gen(function* () {
     // Load all configuration with defaults

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docker-harpoon/core",
-  "version": "0.1.5",
+  "version": "0.3.0",
   "description": "Core Docker resource primitives and binding interface",
   "license": "MIT",
   "files": [

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

@@ -1,10 +0,0 @@
-/**
- * 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

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

package/dist/__tests__/bindings.test.js

@@ -1,128 +0,0 @@
-/**
- * Bindings Integration Tests
- *
- * Dogfoods the binding system to verify:
- * - createEnvBinding helper
- * - Env var injection into containers
- * - Binding composition
- */
-import { describe, test, expect, afterEach, beforeAll, setDefaultTimeout } from 'bun:test';
-import { Container, database, createEnvBinding, destroyAll } from '../index';
-import { buildTestImage, TEST_IMAGE } from './test-setup';
-setDefaultTimeout(30_000);
-const waitUntil = (fn, timeout = 5000) => {
-    return new Promise((resolve) => {
-        const interval = setInterval(() => {
-            if (fn()) {
-                clearInterval(interval);
-                resolve(true);
-            }
-        }, 100);
-    });
-};
-describe('Bindings', () => {
-    beforeAll(async () => {
-        await buildTestImage();
-    });
-    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: TEST_IMAGE,
-            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: TEST_IMAGE,
-            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: TEST_IMAGE,
-            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: TEST_IMAGE,
-            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

@@ -1,12 +0,0 @@
-/**
- * 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

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

package/dist/__tests__/container.test.js

@@ -1,136 +0,0 @@
-/**
- * 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, beforeAll, setDefaultTimeout } from 'bun:test';
-import { Network, Container, destroyAll } from '../index';
-import { buildTestImage, TEST_IMAGE } from './test-setup';
-setDefaultTimeout(30_000);
-describe('Container', () => {
-    beforeAll(async () => {
-        await buildTestImage();
-    });
-    afterEach(async () => {
-        await destroyAll();
-    });
-    test('creates a container with basic config', async () => {
-        const container = await Container('test-container-basic', {
-            image: TEST_IMAGE,
-            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: TEST_IMAGE,
-            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: TEST_IMAGE,
-            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: TEST_IMAGE,
-            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: TEST_IMAGE,
-            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: TEST_IMAGE,
-            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: TEST_IMAGE,
-            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: TEST_IMAGE,
-            cmd: ['sleep', '30'],
-            ports: [{ internal: 8080, external: 18080 }],
-        });
-        expect(container.id).toBeDefined();
-        await container.destroy();
-    });
-    test('streamLogs terminates without follow option', async () => {
-        const container = await Container('test-logs-terminate', {
-            image: TEST_IMAGE,
-            cmd: ['sh', '-c', 'echo "line1" && echo "line2" && echo "line3" && sleep 30'],
-        });
-        await container.waitForLog('line3', 5000);
-        const lines = [];
-        const logStream = await container.streamLogs({ tail: 3 });
-        for await (const line of logStream) {
-            lines.push(line.message);
-        }
-        // Loop should exit naturally
-        expect(lines).toContain('line1');
-        expect(lines).toContain('line2');
-        expect(lines).toContain('line3');
-        await container.destroy();
-    });
-});

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

@@ -1,10 +0,0 @@
-/**
- * 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

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

package/dist/__tests__/database.test.js

@@ -1,78 +0,0 @@
-/**
- * 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('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__/docker-infra.template.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=docker-infra.template.d.ts.map

package/dist/__tests__/docker-infra.template.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"docker-infra.template.d.ts","sourceRoot":"","sources":["../../src/__tests__/docker-infra.template.ts"],"names":[],"mappings":""}

package/dist/__tests__/docker-infra.template.js

@@ -1,174 +0,0 @@
-/**
- * Docker Infrastructure Test Template
- *
- * Copy and customize this file to test your project's Dockerfile and entrypoint.
- * Replace {{PROJECT_NAME}} and {{PROJECT_IMAGE}} with your values.
- *
- * This template demonstrates Harpoon's complete API for testing Docker infrastructure:
- * - Image building with buildArgs
- * - Container creation with volumes, capabilities, and user overrides
- * - Log waiting and streaming
- * - Command execution inside containers
- * - Network isolation testing
- *
- * @example
- * ```bash
- * # Copy and customize for your project
- * cp docker-infra.template.ts my-project.test.ts
- * # Edit PROJECT config and tests
- * bun test my-project.test.ts
- * ```
- */
-import { describe, test, expect, beforeAll, afterEach, setDefaultTimeout } from 'bun:test';
-import { Image, Container, Network, destroyAll } from '@docker-harpoon/core';
-// ============ PROJECT CONFIGURATION ============
-// Customize these values for your project
-const PROJECT = {
-    name: '{{PROJECT_NAME}}',
-    image: '{{PROJECT_IMAGE}}:latest',
-    context: './',
-    dockerfile: 'Dockerfile',
-    port: 3000,
-    healthPath: '/api/status',
-};
-// Set a generous timeout for Docker operations
-setDefaultTimeout(120_000);
-describe(`${PROJECT.name} Docker Infrastructure`, () => {
-    beforeAll(async () => {
-        // Build the project image
-        await Image(PROJECT.image, {
-            context: PROJECT.context,
-            dockerfile: PROJECT.dockerfile,
-            buildArgs: { SEED_DATABASE: 'true' },
-        });
-    });
-    afterEach(async () => {
-        await destroyAll();
-    });
-    // ============ HEALTH CHECK TEST ============
-    test('health check responds 200', async () => {
-        const container = await Container('test-health', {
-            image: PROJECT.image,
-            env: { PORT: String(PROJECT.port) },
-            ports: [{ internal: PROJECT.port, external: 13000 }],
-        });
-        await container.waitForLog(/listening|started|ready/i, 30000);
-        const res = await fetch(`http://localhost:13000${PROJECT.healthPath}`);
-        expect(res.status).toBe(200);
-    });
-    // ============ VOLUME MOUNT TEST ============
-    test('db snapshot copy-on-boot pattern', async () => {
-        const container = await Container('test-snapshot', {
-            image: PROJECT.image,
-            env: {
-                DB_SOURCE: '/data/snapshot/app.db',
-                DB_PATH: '/app/data/test.db',
-            },
-            volumes: [
-                { hostPath: '/tmp/test-snapshot.db', containerPath: '/data/snapshot/app.db', readonly: true },
-            ],
-        });
-        await container.waitForLog(/snapshot copied|database ready/i, 30000);
-    });
-    // ============ FILE SYSTEM TEST ============
-    test('file upload directory setup', async () => {
-        const container = await Container('test-uploads', {
-            image: PROJECT.image,
-            env: { FILE_UPLOAD_PATH: '/app/custom-uploads' },
-        });
-        await container.waitForLog(/upload directory|ensuring/i, 10000);
-        const result = await container.exec(['ls', '-la', '/app/custom-uploads']);
-        expect(result.exitCode).toBe(0);
-        expect(result.stdout).toContain('drwx'); // Directory exists with permissions
-    });
-    // ============ NETWORK ISOLATION TEST ============
-    test('network isolation with iptables', async () => {
-        const network = await Network('isolated-net');
-        const container = await Container('test-isolation', {
-            image: PROJECT.image,
-            networks: [network],
-            env: { ENABLE_NETWORK_ISOLATION: 'true' },
-            capAdd: ['NET_ADMIN'],
-        });
-        await container.waitForLog(/network isolation configured|iptables/i, 15000);
-    });
-    // ============ PRIVILEGE DROPPING TEST ============
-    test('privilege dropping', async () => {
-        const container = await Container('test-privileges', {
-            image: PROJECT.image,
-        });
-        await container.waitForLog(/dropping privileges|started/i, 15000);
-        const result = await container.exec(['whoami']);
-        expect(result.exitCode).toBe(0);
-        expect(result.stdout.trim()).not.toBe('root');
-    });
-    // ============ ENVIRONMENT VARIABLE TEST ============
-    test('environment variable propagation', async () => {
-        const container = await Container('test-env', {
-            image: PROJECT.image,
-            env: {
-                PORT: '8080',
-                LOG_LEVEL: 'debug',
-                CUSTOM_VAR: 'test-value',
-            },
-            ports: [{ internal: 8080, external: 18080 }],
-        });
-        await container.waitForLog(/listening|started/i, 30000);
-        // Verify env vars are set
-        const envResult = await container.exec(['printenv']);
-        expect(envResult.stdout).toContain('PORT=8080');
-        expect(envResult.stdout).toContain('LOG_LEVEL=debug');
-        expect(envResult.stdout).toContain('CUSTOM_VAR=test-value');
-    });
-    // ============ USER OVERRIDE TEST ============
-    test('user override', async () => {
-        const container = await Container('test-user', {
-            image: PROJECT.image,
-            user: '1000:1000',
-        });
-        await container.waitForLog(/started|ready/i, 15000);
-        const result = await container.exec(['id']);
-        expect(result.exitCode).toBe(0);
-        expect(result.stdout).toContain('uid=1000');
-        expect(result.stdout).toContain('gid=1000');
-    });
-    // ============ CAPABILITIES TEST ============
-    test('dropped capabilities', async () => {
-        const container = await Container('test-caps', {
-            image: PROJECT.image,
-            capDrop: ['ALL'],
-            capAdd: ['NET_BIND_SERVICE'],
-        });
-        await container.waitForLog(/started|ready/i, 15000);
-        // Container should be running with minimal capabilities
-        const result = await container.exec(['cat', '/proc/1/status']);
-        expect(result.exitCode).toBe(0);
-        // CapEff should show limited capabilities
-        expect(result.stdout).toContain('CapEff');
-    });
-    // ============ GRACEFUL SHUTDOWN TEST ============
-    test('graceful shutdown', async () => {
-        const container = await Container('test-shutdown', {
-            image: PROJECT.image,
-            env: { PORT: String(PROJECT.port) },
-        });
-        await container.waitForLog(/listening|started|ready/i, 30000);
-        const metadata = await container.stop('SIGTERM', 10000);
-        expect(metadata.graceful).toBe(true);
-        expect(metadata.signal).toBe('SIGTERM');
-    });
-    // ============ RESOURCE STATS TEST ============
-    test('container stats', async () => {
-        const container = await Container('test-stats', {
-            image: PROJECT.image,
-            env: { PORT: String(PROJECT.port) },
-        });
-        await container.waitForLog(/listening|started|ready/i, 30000);
-        const stats = await container.stats();
-        expect(stats.cpu).toBeDefined();
-        expect(stats.cpu.percent).toBeGreaterThanOrEqual(0);
-        expect(stats.memory).toBeDefined();
-        expect(stats.memory.usage).toBeGreaterThan(0);
-        expect(stats.network).toBeDefined();
-    });
-});

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

@@ -1,10 +0,0 @@
-/**
- * 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

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

package/dist/__tests__/network.test.js

@@ -1,44 +0,0 @@
-/**
- * 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/__tests__/test-setup.d.ts

@@ -1,9 +0,0 @@
-/**
- * Shared test setup for integration tests.
- *
- * Builds a minimal test image that can be used across all tests,
- * ensuring tests are self-contained and don't rely on external images.
- */
-export declare const TEST_IMAGE = "harpoon-test:latest";
-export declare function buildTestImage(): Promise<void>;
-//# sourceMappingURL=test-setup.d.ts.map

package/dist/__tests__/test-setup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../../src/__tests__/test-setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,UAAU,wBAAwB,CAAC;AAWhD,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAapD"}

package/dist/__tests__/test-setup.js

@@ -1,27 +0,0 @@
-/**
- * Shared test setup for integration tests.
- *
- * Builds a minimal test image that can be used across all tests,
- * ensuring tests are self-contained and don't rely on external images.
- */
-import { Image } from '../index';
-import { join } from 'path';
-export const TEST_IMAGE = 'harpoon-test:latest';
-let imageBuilt = false;
-// Get the source directory path (works in both ESM and CJS)
-const getFixturesDir = () => {
-    // Try to resolve from source directory first
-    const srcDir = join(process.cwd(), 'src', '__tests__', 'fixtures');
-    return srcDir;
-};
-export async function buildTestImage() {
-    if (imageBuilt) {
-        return;
-    }
-    const fixturesDir = getFixturesDir();
-    await Image(TEST_IMAGE, {
-        context: fixturesDir,
-        dockerfile: 'Dockerfile',
-    });
-    imageBuilt = true;
-}